Connect your AI agent

Use NEXT's research tools from the AI app you already work in: read charts, check a rule, run a backtest. Everything here reads or computes; nothing places an order or moves funds.

Server address

Paste this address into your AI client. It speaks the open MCP standard over HTTPS.

Address
https://YOUR-MCP-HOST/mcp

The public address is not set yet. The text above is a placeholder; replace it with the address you were given.

Every call needs your NEXT API key (it starts with nxk_), sent as a Bearer header. Keep it private. Don't have one? Ask the NEXT team.

Set up your client

Claude Desktop connects through a small bridge that can send your key. Claude on the web uses connectors (see the note).

  1. Open Claude Desktop, then Settings, then Developer, then Edit Config.
  2. Paste the config below into the file and replace nxk_YOUR_KEY with your key.
  3. Save the file and restart Claude Desktop.
  4. Start a new chat and ask for the tools: you should see the NEXT tools listed.
Config (JSON)
{
  "mcpServers": {
    "next": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://YOUR-MCP-HOST/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer nxk_YOUR_KEY"
      }
    }
  }
}

Claude on the web adds connectors under Settings, then Connectors, then Add custom connector. At the time of writing those sign in with OAuth rather than a key, so use the desktop config until account sign-in is available.

Let your agent set it up

Give this text to an agent that can edit its own config (Claude Code, Codex, Cursor) and it will do the setup for you. It never contains your key.

Text for your agent
Set up the NEXT MCP server for me.
Server address: https://YOUR-MCP-HOST/mcp
Transport: Streamable HTTP. Send my NEXT API key in the header "Authorization" as "Bearer" followed by the key. Ask me for the key and never print it back.
Name the server "next". When it is added, list its tools to confirm the connection.

Try it

Once connected, paste this into a chat.

Test prompt
Use the NEXT tools to read the last 200 hourly bars of BTC/USDT:USDT on Binance, then show where the market structure has broken recently and which fair-value gaps are still open. Quote the prices the tools return.

Available tools

Each one calls the same function the product itself uses. None of them places orders, starts bots or moves funds.

Markets and charts

  • get_chart_bars

    Recent price bars for one market, with a summary of the window.

  • get_chart_structure

    Swing structure, breaks and key gaps, computed as the chart computes them.

  • propose_trade_setup

    Checks a setup you wrote against the last closed price and returns a card. Read-only.

  • signal_preview

    Where a rule would have fired on the last closed bars.

Rules and scripts

  • compile_nextscript

    Compiles a NextScript indicator or strategy and reports what it needs or what is unsupported.

  • validate_rule

    Checks one calculated rule for a strategy slot without running it.

  • list_atoms

    The conditions your plan can use, optionally one category.

  • sizing_envelopePaid per call, testnet

    First and worst-case position size and margin of a sizing setup.

Research jobs

  • estimate_research_job

    Cost, daily limit and trial ceiling before you start a backtest or study.

  • backtest_start

    Queues one backtest on your plan's quota.

  • backtest_status

    Status of a backtest, with the result once it is done.

  • backtest_result

    The finished backtest: verdict, measured facts and sample size.

  • optimize_start

    Queues an optimizer study on your plan's quota.

  • optimize_status

    Progress of an optimizer study.

  • optimize_result

    The finished study: trial count, deflated Sharpe and walk-forward fields.

Payments

Paid calls run on testnet only; mainnet is not enabled. During the beta the paid tool is free for API-key holders and nothing is charged.

Back to the AI workspace