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.
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, through the REST API. Search a market (
GET /api/data/SearchSymbols), take the id it returns, and pass it to the analyses. The API brings the data up to date and answers with the cycles. The prices themselves are not part of the answer. The MCP server takes no market data. 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.