Cycles IQ API and MCP
Cycles IQ measures the cycles in a time series: which cycles are active, how strong and how reliable each one is, where each one stands in its phase, and where the combined cycles point next. The same model answers two ways:
- MCP: connect Claude, ChatGPT, Claude Code, Cursor or any other MCP client to
https://api.cyclesiq.com/mcpand ask in plain language. The assistant picks from 15 tools. - REST API: call
https://api.cyclesiq.comfrom your own code, with an API key.
Every call needs a Cycles IQ account. Signing up is free, and a new account starts with the 30-day trial. See Plans and limits.
Where these pages fit
Cycles IQ comes in three ways. These pages document the first one; the other two build on it.
- Cycles IQ App, API and MCP. The Cycles IQ app at
app.cyclesiq.comwith your own dashboards, cycle scoring templates and lenses, the REST API and the MCP server, and the public Cycles API skill for your AI coding tool. Open to everyone. - Cycles IQ Membership. Your own flows and scripts (the filters, scans and alerts that run on your markets) in your own environment, the private skill files and the Cycles IQ backend for your infrastructure. By invitation.
- Cycles IQ Pro Membership. Everything of the Cycles IQ Membership, plus knowledge of how to use cycles in the markets and development support from our team. By invitation.
The last two start with a request: see Cycles IQ.
What you can analyse
- Your own series. Send the values with the call, or store them once as a dataset and name it in later calls. Prices, economic data, indicators, sensor readings: any regular series of numbers. Through the MCP the assistant brings the data: from another connector (a market-data connector, for example), a file or the numbers you give it.
- Markets by id, with the feature
MarketDataAccess. Search a market (GET /api/data/SearchSymbols, or the toolsearch_symbols), take the id it returns, and pass it to the analyses. The API brings the data up to date and answers with the cycles; through the MCP the prices are never part of the answer. The feature is granted on request to known customers; no plan includes it. See Market data by id.
What you get back
| You want to know | Use |
|---|---|
| Which cycles are in the series, ranked by strength and reliability | cycle scanner |
| The dominant cycle, its phase and its projection forward | cycle explorer (for a market by id: market cycles) |
| Whether a series is bullish or bearish in cycle terms | consensus score |
| An oscillator tuned to the dominant cycle | cyclic RSI (CRSI) |
| A cleaner series before the analysis | detrend, Savitzky-Golay and sinc smoothing |
| Where the trend turned | RSD turning-point test |
| Which cycle lengths cluster together | KDE clustering |
| Which series move alike | DTW clustering |
Concepts explains how to read every answer: cycle length, amplitude, Bartels score, phase, projections, CRSI and the consensus.
Where to start
- Getting started: connect an AI assistant or make your first REST call.
- Plans and limits: the free account, the 30-day trial and what each plan allows.
- MCP tools and REST API: every tool and every route.
- Workflows and examples: worked examples, from a single scan to a portfolio screen.
- Answers and errors: what each status code means and what to do.
The answers are measurements and projections of cycles, not investment advice.
Answers of Cycles IQ are measurements and projections of cycles, not investment advice. Questions: support.