{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_dxfr3tbfegx5","handle":"spectre-terminal-mcp","url":"https://wellknown.network/agents/spectre-terminal-mcp","links":{"self":"https://wellknown.network/agents/spectre-terminal-mcp/record.json","html":"https://wellknown.network/agents/spectre-terminal-mcp","markdown":"https://wellknown.network/agents/spectre-terminal-mcp/record.md","api":"https://wellknown.network/api/v1/agents/spectre-terminal-mcp","status":"https://wellknown.network/api/v1/agents/spectre-terminal-mcp/status","claim":"https://wellknown.network/agents/spectre-terminal-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/spectre-terminal-mcp/claim.json","badge":"https://wellknown.network/agents/spectre-terminal-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/spectre-terminal-mcp/history","tools":"https://wellknown.network/api/v1/agents/spectre-terminal-mcp/tools"},"ard":{"identifier":"urn:air::server:spectre-terminal-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"spectre-terminal-mcp","summary":"MCP server that gives AI agents a running Spectre Terminal over its Local API: market data, the account, trading, the layout and settings","description":"# spectre-terminal-mcp\n\nAn [MCP](https://modelcontextprotocol.io) server that lets an AI agent — Claude\nCode, Claude Desktop, Cursor, any MCP client — read market data from a\nrunning [Spectre Terminal](https://spectre.trade) on the same machine, and\ntrade through it. Thin, stdio; built on the `spectre-terminal` Python client.\n\n```bash\npip install spectre-terminal-mcp\n```\n\n## Setup\n\nSwitch the Local API on in the terminal (**Settings App → General → Local\nAPI**) and copy the token. Then register the server with your client:\n\nClaude Code:\n\n```bash\nclaude mcp add spectre-terminal -e SPECTRE_LOCAL_API_TOKEN=spt_… -- spectre-terminal-mcp\n```\n\nClaude Desktop (`claude_desktop_config.json`), Cursor and others:\n\n```json\n{\n  \"mcpServers\": {\n    \"spectre-terminal\": {\n      \"command\": \"spectre-terminal-mcp\",\n      \"env\": { \"SPECTRE_LOCAL_API_TOKEN\": \"spt_…\" }\n    }\n  }\n}\n```\n\nThe server finds the port through the terminal's `instance.json` and reads\nthe token from the environment only. It starts even when the terminal is not\nrunning; the first tool call then answers `terminal_unreachable`.\n\n## Tools\n\n| Tool | Answers |\n| --- | --- |\n| `terminal_status` | version, health, stream topics, every connection with id, exchange, market, state |\n| `find_instrument` | the exact `exchange:market:symbol` for a coin or symbol, best match first |\n| `market_snapshot` | last price, best bid and ask with spread, mark, 24h change and volume |\n| `order_book_top` | top N levels per side, volumes, imbalance |\n| `recent_trades_summary` | buy and sell volume, delta, VWAP, range, largest print over the last N trades |\n| `cluster_summary` | the newest buckets: volume by side, delta, VWAP, the busiest price levels |\n| `candles` | OHLCV rows for an interval |\n| `account_overview` | balances, positions with PnL, open order counts of one connection |\n| `open_orders` | open orders and triggers with the terminal's `key` and the exchange id |\n| `recent_fills` | the latest fills with buy and sell volume total…","publisher":null,"homepage":"https://github.com/spectre-trade/spectre-terminal-sdk","repository":"https://github.com/spectre-trade/spectre-terminal-sdk/blob/main/CHANGELOG.md","version":"0.1.0rc2","license":null,"protocols":["mcp"],"tags":["spectre","trading","terminal","mcp","model-context-protocol","market-data"],"pricing":null,"endpoints":[{"url":"pypi:spectre-terminal-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":1,"provenance":"declared"},{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"declared"}],"categories":["dev","finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"spectre-terminal-mcp","registry":"pypi","observedAt":"2026-11-05T22:26:32.574Z","publishedAt":"2026-11-05T09:38:26.995324Z","latestVersion":"0.1.0rc2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"spectre-terminal-mcp","url":"https://pypi.org/project/spectre-terminal-mcp/","firstSeenAt":"2026-11-05T22:25:37.713Z","fetchedAt":"2026-11-05T22:25:37.713Z","normalizedAt":"2026-11-05T22:25:37.713Z"}]},"firstSeenAt":"2026-11-05T22:25:37.713Z","updatedAt":"2026-11-05T22:26:32.574Z"}