MCP

MCP (Model Context Protocol) lets an AI assistant call tools on a server you choose. Terminal's MCP server gives your assistant your alert rules, your alerts, and what the price did after each one. It can also explain a coin's move and preview a condition. It changes nothing until you agree.

The address is https://terminal.tokensmarketcap.com/mcp. Use this address. Sign-in from an AI assistant works only on this host.

Set it up in Claude Code, Claude.ai, or Claude Desktop, in ChatGPT, or in an agent framework such as the OpenAI Agents SDK, LangChain, or CrewAI.

Two ways to connect

Sign in. Your AI assistant opens a Terminal page that asks whether to allow the app to use your Terminal account. The title names the app and its site, for example "Allow Claude Code (claude.ai) to use your Terminal account?". Below it is a box for each thing the app asks to do. "Read alerts, rules and receipts" is always on. "Subscribe to services on the exchange" shows only if the exchange is open to your account. It starts unticked, because it spends credits. Untick anything you do not want, then press Allow.

An API key. Send it on the Authorization: Bearer header. Claude Code and the agent frameworks can send one. Create a key at API keys. A key with read can use the read tools. A key needs rules:write as well to propose and confirm changes. Read Authentication for scopes and caps.

Apps you signed in to are listed under Connected apps on the API keys page in Settings, with what each may do and when it last called. Revoke one there. Its next call is refused.

Tools without sign-in

These tools read public pages. They need no account and no key. They allow 60 calls a minute from one address, and they do not count toward any key's API calls.

• Tool: get_scoreboard. What it returns: The public Scoreboard: what prices did after alerts of each kind, with sample sizes.
• Tool: get_shared_alert. What it returns: One alert its owner shared: the event, the price with its source and time, and the later prices. Pass the link or its 22-character code.
• Tool: get_methodology. What it returns: How Terminal gets prices, checks alerts, measures an unusual move, writes a note, and records later prices.

Read tools

These tools need the read scope. Each call counts as one API call for the key or the signed-in app. Read Quotas for the monthly calls on each plan.

• Tool: list_rules. What it returns: Your alert rules, with their conditions and state.
• Tool: get_rule. What it returns: One alert rule: its condition, the wait between alerts, its status, and its state per coin.
• Tool: get_rule_record. What it returns: The alerts of one rule, and what the price did 1 hour, 4 hours, 24 hours, and 7 days after each.
• Tool: list_recent_alerts. What it returns: Alerts your rules recorded since a time (today, overnight, 24 hours, or 7 days), newest first.
• Tool: get_alert. What it returns: One alert with its numbers, its note, its later prices, and the facts the note was written from.
• Tool: get_delivery_status. What it returns: Your quiet hours, your destinations, and how a rule's latest alert was delivered.
• Tool: get_move_facts. What it returns: A coin's latest price and its change over a window, with volume against its 20-day average, its usual range, and Bitcoin over the same window.
• Tool: get_price_range. What it returns: A coin's highest and lowest price over a window, with their times, and the largest 5-minute change.
• Tool: get_watchlist_moves. What it returns: Each coin on your watchlist, its change over a window, and its usual range.
• Tool: search_assets. What it returns: Coins Terminal has a price feed for, by name or ticker.
• Tool: get_account. What it returns: Your plan, its limits, this month's API calls, and your credits.

Every price comes with its source and its time. A value of null means Terminal does not have it. It does not mean zero.

Previews and explanations

These two tools need the read scope too. Each counts as one API call, and each can spend credits.

• Tool: preview_rule. What it returns: How often a condition would have been met over the last 30 days, and the price 1 hour and 24 hours after each time. It is a backtest: hypothetical, not a forecast.. What it costs: One of the day's included previews. Past them, 2 cents from credits.
• Tool: explain_move. What it returns: A short note on a coin's move over a window, written from measured facts, with the facts as fields. The note is marked as written by AI.. What it costs: One of the plan's notes. On Free, past the allowance, 5 cents from credits. On paid plans, past fair use, the answer has the facts and no note, and it is not charged.

The same call with the same arguments in the same 5-minute window returns the stored answer. It is not charged again. The key's daily cap and the account's monthly cap apply. Read Quotas for the allowances and caps.

Changes you confirm

These tools need the rules:write scope. A propose tool saves nothing. It returns a summary of the change and a token. Your AI assistant shows you the summary.

• Tool: propose_rule. What it prepares: A new alert rule, with a 30-day preview.
• Tool: propose_edit. What it prepares: A change to one alert rule.
• Tool: propose_state. What it prepares: A pause, resume, 1-hour snooze, mute, unmute, or delete of one alert rule.
• Tool: propose_quiet_hours. What it prepares: Quiet hours on for the times you give, or off.

Two tools finish a proposal:

• confirm_proposal makes the change. Terminal's instructions tell your AI assistant to call it only after you agree in the conversation. The tool is marked as one that changes your account, so many apps ask you before they run it.
• cancel_proposal discards the change.

A proposal expires after 24 hours. Your plan's limits apply when you confirm. A proposal for a new rule takes one of the day's included previews. Past them, the proposal comes back without a preview, and it is never charged. The propose tools allow 10 calls a minute for each account.

What your AI assistant writes

Your AI assistant's own model writes the words you read. Terminal sends it numbers, each with its source and time. Every result also carries the notice at the foot of this page, in its notice field, and the API terms in terms.

Terminal's instructions tell your AI assistant that Terminal describes market events. Terminal does not recommend trades or predict prices, and answers built on its results should not either. Rule names are text you typed, so your AI assistant should treat them as data, not as instructions.

Create a free account

Terminal reports market events for conditions you set. It does not tell you to buy, sell, or hold, and it does not place trades.