Skip to content

DEBYKO for AI agents

An AI client connected to DEBYKO’s MCP server reads market data from perpetual-futures venues, each value as the venue published it, and sets up Agent alerts with you: it links your Telegram, writes the condition with you, creates the rule, shows what the rule answers right now and how to turn it off.

  • Read: the venues, the instruments, the latest values, history, candles, a DQL screen across venues, the state of your Agent rules, and your plan with what is left of it today. Every tool is in MCP tools.
  • Alerts: connect Telegram or a webhook, create, pause, resume, edit and delete rules, and turn Agent off and on, as in Alerts. These tools are turned on account by account; until they are on for yours, the AI gives you the steps to do the same by hand at https://agent.debyko.com.
  • Explain: the server carries its own guides (docs://getting-started, docs://agent, docs://plans, docs://dql, docs://layers), so the AI answers “how do I…” from them, with the pages and buttons as they are.

The MCP server is https://mcp.debyko.com/mcp (Streamable HTTP).

  • claude.ai, Claude Desktop: Customize → Connectors → + Add → Add custom connector, paste the URL, then Continue → Add → Connect. The client sends you to studio.debyko.com: sign in, check the request and press Allow.
  • ChatGPT (chatgpt.com on a computer only): Plugins → + → Add custom MCP server, paste the URL, choose OAuth, then Create; it signs in the same way (Allow). Developer mode, if ChatGPT asks for it, is under Settings → Apps → Advanced settings.
  • Claude Code: claude mcp add --transport http debyko https://mcp.debyko.com/mcp, then run /mcp and authenticate. With a key instead: add --header "Authorization: Bearer <key>".
  • Cursor: in .cursor/mcp.json, {"mcpServers": {"debyko": {"url": "https://mcp.debyko.com/mcp"}}} signs in with OAuth; add "headers": {"Authorization": "Bearer <key>"} to use a key.
  • Any MCP client that sets a header: the URL and Authorization: Bearer <key>. An account opened by signing in on the sign-in page (or from the documentation, or from a plan button) shows its API key once, on the page Your account is open: press Copy; under the key the page has the first request, ready to paste with the key in it (an account opened by connecting an AI client with OAuth, or from Studio or Agent, has no key of its own until you make one). For another key later, open https://studio.debyko.com/account and under API keys press Issue a key (or open the ⋯ menu of the key you have and press Rotate, then Rotate key: a new key with the same label is shown once, and the old one stops working within 30 seconds).

After Allow the client gets its code at once and takes over. The consent page and the Application connected page show After connecting, ask your AI: “Compare BTC funding across all venues right now, with the age of each value.” Paste that question into your AI chat; connecting does not run a market-data request by itself. Until you ask something, studio.debyko.com/account also shows Connected — ask this in your chat, as a card you can Dismiss.

If the consent page is submitted or refreshed again from the same signed-in session, the original decision is kept: an unexchanged, unexpired approval returns the same code; a completed connection says This application is already connected. An expired approval says Start a new connection from the application. A repeated Deny keeps the original denial; an old Deny form cannot undo an approval. End access under Connected applications instead.

A connection is ended under Connected applications at https://studio.debyko.com/account (End).

You need a DEBYKO account for the data that needs a key, and for alerts: Open https://studio.debyko.com/account/signin, enter your email and press Send the code, then enter the code from the email and press Sign in. The Free plan is free and needs no card. The rest is in Getting started.

Clients that show MCP prompts offer it as setup; anywhere else, paste it:

Set up DEBYKO for me. Call account to check my account and plan (if it fails because I am not signed in, give me the steps from the error’s next). Then call agent_channels: if Telegram is not linked, call agent_channel_connect with kind telegram, give me its steps, and check again after I press Start. Then help me create a first alert: make the condition concrete on a venue listed by venues, ask me for its label, create it with agent_rule_create, and show me the dry run and how to turn it off.

Every tool call counts as one request on your key, except venues and instruments (free), account (not counted against the day) and the Agent tools that set up alerts (not counted on the key: Agent’s own limits apply). What each plan allows — requests a day, venues, history, Agent rules, the shortest check interval, checks a minute, webhooks and Telegram chats — is on https://debyko.com/#pricing, and for the AI in docs://plans; both are read from the plan table the API and Agent enforce. A call refused for a limit says which one and what to do: see Errors.