CandleStack for agents
Almost everything you do in the app, an agent will be able to do for you. Connect Claude, ChatGPT or Cursor through MCP, or call the API from your own code.
On this page
Coming soon. The MCP server and API keys are being built and are not live yet. This page says what they will do and what works today.
What an agent can do
Once the server is live, an agent works with the same things you do in the app. It sees your own models and backtests and what others published to Experiments, nothing else. Agents work for accounts on the beta list.
- Find dataSearch US stocks and crypto and read candles in any timeframe from 1m to 1d.
- Check modelsRead the manifest of a model and test a new one before you save it.
- Upload modelsGet a one-time link and send a Keras or ONNX file from your own disk.
- Run backtestsStart backtests, wait for them and read the metrics and trades.
- ComparePut 2 to 20 backtests side by side, with the best and worst value of each metric marked.
- SweepRun one setup over a grid of representations, timeframes and periods.
- PublishShare a good backtest in Experiments, or take it back.
MCP or the API
For chats and coding agents
Add one address to your AI client. The agent picks the tools, runs them and explains what it found.
- Claude Code, Cursor and VS Code will sign in with a key
- claude.ai and ChatGPT will sign in with your account
- Asks before it deletes or publishes
The install steps come with the server.
For scripts and your own code
Send JSON over HTTPS with a key in the header. Good for notebooks, scheduled jobs and pipelines.
- The same actions as the MCP tools
- Keys with scopes and an expiry
- The reference of every endpoint is live today
Not sure? Start with MCP once it is live. You can script the same steps later.
First backtest from a chat in 2 minutes
Coming soon. These steps work once the MCP server and API keys are live. Until then, run your backtests in the app.
- 1Create a key
In the settings of the app, create a key with the
readandbacktestsscopes. On claude.ai and ChatGPT you will sign in with your account instead. - 2Add the server
Add the address of the CandleStack server to your AI client. The address and the steps for each client come with the server.
- 3AskPrompt
Run my newest model on AAPL for the first half of 2025 with my usual settings. Then tell me how it did against buy and hold.
The agent finds your model, checks the setup, starts the backtest, waits for it and answers with the metrics and a link to the backtest in the app.
What works today
- Web appBuild, run and compare backtests in the app with an account on the beta list.
- API referenceEvery endpoint with its fields in the reference. Until keys arrive, a script signs in with the session cookie of your browser, as the API guide shows.
- These docsEvery page as Markdown and all of them in one file, see Docs for agents.
What stays in the web app
Deleting your account, your sign-in methods and signing out stay in the app. No key and no agent can do them.
Next
- Docs for agentsRead these docs as Markdown, one page or all at once
- Problem typesEvery error of the API and what to do about it
The install steps, the tool reference, the API guide and the use cases come with the server.