Start with your agent
Opening Claude Desktop with this prompt typed in. Nothing opened? It may not be installed here: copy the prompt into any agent.
Read https://aperiodic.io/start.md and follow it. Then find where this project loads market data from Laevitas, and show me how the same series would load from Aperiodic, side by side, before changing anything.It sends your agent to one short Markdown file, /start.md, and asks it to follow it. You can read the file before you paste the line. On a first run it tells your agent to:
Install the Python client from PyPI with pip install "aperiodic[polars]", in a virtualenv if your project has none. If the Aperiodic MCP tools are already connected in your app, skip this and fetch the preview through them.
Fetch the free preview, which needs no key: taker order flow (flow) for BTC on Binance in 5m bars, 2025-05-01 to 2025-05-31.
Reply in a few lines: the five bars with the biggest net flow as a small table, how often buyers led, three questions it could answer with a key, and where to create one.
If you typed a question after the line, work on that instead, and ask once for a key if it needs data beyond the preview.
Ask you before keeping anything: with your yes, save the file as a skill and add Aperiodic as an MCP server.
After that, it reads your key from APERIODIC_API_KEY, or asks you for it once.
Agents that run in a cloud sandbox can only reach the domains their app allows. If the first run stops at the fetch or the install, allow these:
*.aperiodic.io covers the files of every dataset.Where to allow them:
Buttons across the site, from the catalog and the API docs to notebooks, the guide and Pre-flight, open your agent with one of these. Each reads a skill file and then does one task. The underlined words are what the page you came from fills in.