---
name: debyko-agent-skill
description: Set up DEBYKO for an AI client: connect the MCP server, create a free account, verify, and know what to ask for. Covers Claude, ChatGPT, Claude Code, Cursor and other MCP clients.
---

# DEBYKO

Market data from 16 perpetual-futures venues, stored as each venue published it: every value carries the venue, the venue's timestamp, the time DEBYKO received it and its age. Missing, stale and not-published values are reported as such, never as zero. Agent adds alert rules in DQL delivered to Telegram or a webhook.

MCP endpoint: `https://mcp.debyko.com/mcp` (OAuth 2.1; an API key as Bearer also works).
Signing in during OAuth creates a free account (email + one-time code, no card).

## Connect

- **Claude (claude.ai / desktop):** Settings → Connectors → Add → Add custom connector → Name `DEBYKO`, URL `https://mcp.debyko.com/mcp` → Add → Connect → sign in with email code → Allow.
- **ChatGPT:** Plugins (left sidebar) → Add → Add custom MCP server → MCP server URL `https://mcp.debyko.com/mcp` → OAuth → sign in. (Or install the DEBYKO plugin from the ChatGPT plugin directory when listed.)
- **Claude Code:** `claude mcp add --transport http debyko https://mcp.debyko.com/mcp`, then `/mcp` to sign in.
- **Cursor:** open `cursor://anysphere.cursor-deeplink/mcp/install?name=debyko&config=eyJ1cmwiOiJodHRwczovL21jcC5kZWJ5a28uY29tL21jcCJ9`, or add `{"mcpServers":{"debyko":{"url":"https://mcp.debyko.com/mcp"}}}` to `~/.cursor/mcp.json` (Cursor Settings → Plugins & MCPs shows it).
- **Other MCP clients:** add the URL as a remote (streamable HTTP) server; if the client has no OAuth, create an API key at https://studio.debyko.com/account and send it as `Authorization: Bearer <key>`.

Request all scopes offered by the server's protected-resource metadata.

## Verify

Call `account` (free, does not count against limits). Report the plan, venues and remaining requests. If no DEBYKO tools are available, report that verification is blocked rather than claiming success.

## Use

Start with `venues`, then `instruments` (`where base = BTC`), then `snapshots`. DQL screening: `screen`; the language is in the resource `docs://dql`. History: `candles`, `history`. Anchored-history proofs: `anchor_proof`.
Examples of what to ask: "compare BTC funding across venues", "ETH open interest on Hyperliquid vs Binance", "which venues quote SOL-PERP with funding below zero".

## Alerts

Agent is open to every DEBYKO account, Free included. Each plan sets how many rules run at once, the shortest check interval and how many webhooks; the numbers are at https://debyko.com/#pricing. Rules live at https://agent.debyko.com: New rule → condition (DQL) → interval → channel → label. Telegram: Channels → Connect Telegram → press Start in @debyko_bot. Rules fire when the condition turns from false to true. Notifications state the condition met; they never say buy or sell.

## Other needs

Docs: https://docs.debyko.com/ai/ · https://debyko.com/llms.txt · Support: support@debyko.com
If a step fails, report the specific blocker; do not substitute another data source.