Radon Terminal MCP server
Updated 2026-09-05
Radon Terminal publishes a hosted, read-only Streamable HTTP MCP at https://app.radon.run/mcp. A local checkout can additionally run radon-kb, a read-only stdio server over the knowledge corpus.
01Hosted MCP
Endpoint: https://app.radon.run/mcp (MCP Streamable HTTP JSON-RPC). Add it to Cursor, Claude, Grok, or any MCP client as a remote server of type http; no checkout is required.
Send Accept: application/json, text/event-stream. Authentication is an optional Authorization: Bearer header carrying a Clerk session token from demo.radon.run or the operator terminal.
The server is read-only. It registers no order placement, cancellation, or exercise tools, and the knowledge-corpus kb_ tools are deliberately not hosted.
02Hosted tool rungs
No token: radon_identity, radon_docs, and radon_health. Product identity, public radon.run documents as markdown, and the trust-scoped edge health verdict. No live quotes, no portfolio.
Demo Clerk token (free trial at https://demo.radon.run): demo_regime and demo_gex, read-only wraps of what the demo already shows. No Interactive Brokers data and no operator book.
Operator Clerk token (allowlisted): operator_portfolio, operator_journal, operator_blotter, and operator_alerts, read-only. A demo token calling an operator tool is refused.
03Local radon-kb (stdio)
From a Radon checkout: .venv/bin/python scripts/knowledge/mcp_server.py
Project registration is in .mcp.json as radon-kb, type stdio, with RADON_DB_NO_REPLICA=1.
The server needs the same Turso credentials the repo already uses. It issues SELECTs only.
04radon-kb tools
kb_search: hybrid retrieval over journal, evals, docs, newsfeed, and incidents.
kb_recent: newest corpus rows by last_activity_at.
kb_prior_evals: prior journal and evaluation rows for one ticker.
kb_incidents: incident writeups, optionally filtered by service name.
05Which MCP to use
Use the hosted MCP at https://app.radon.run/mcp when there is no Radon checkout: product identity, public docs, demo reads, and (for the operator) journal, portfolio, blotter, and alert reads.
Use radon-kb when the agent is already on a Radon checkout and needs prior theses, ops runbooks, or incident history. The knowledge corpus is not exposed on the hosted server.