circuit-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CIRCUIT_WALLET | No | base58 secret key that funds micropayments (omit → free tools only) | |
| CIRCUIT_RPC_URL | No | Solana RPC used to send payments — set your own; the public default rate-limits | |
| CIRCUIT_DATA_URL | No | override the data API base | https://api.circuitllm.xyz |
| CIRCUIT_TREASURY | No | if set, only ever pay this address (recipient allow-list — recommended) | |
| CIRCUIT_MCP_TIMEOUT_MS | No | outer per-tool-call backstop (a genuinely stuck call returns a clean error) | 120000 |
| CIRCUIT_MCP_MAX_SPEND_CIRC | No | per-call CIRC spend cap | 1000 |
| CIRCUIT_MCP_MAX_TOTAL_CIRC | No | per-process CIRC cap — the runaway-spend guard; paid tools stop once reached | 50000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| circuit_quoteA | FREE. List every Circuit data tool with its live cost in USD and CIRC. Call this first to see what each paid tool costs. |
| token_priceA | FREE. Aggregated USD price for a Solana token (Jupiter + DexScreener + CoinGecko, with on-chain price-feed fallback). |
| live_pricesA | FREE. Sub-second batch prices for up to 20 mints straight from the Circuit gRPC indexer (Redis reads). |
| scanC | FREE. The Circuit on-chain dip-reversal scanner: freshly scored candidates from the live gRPC feed. |
| swarm_feedC | ~$0.002 in CIRC. Live buy/sell/rug signals published by the Circuit trading-agent swarm — signal data unique to Circuit. |
| swarm_consensusC | ~$0.002 in CIRC. The swarm's reputation-weighted view on ONE token: bullish / bearish / rug_alert with confidence. |
| token_securityA | ~$0.003 in CIRC. Rug-risk audit: authority analysis, LP lock %, creator balance, and full risk flags by category. |
| token_overviewA | Price + metadata + security audit + active pools in a single call (replaces four). Priced per /api/quote (~$0.003 in CIRC; often free). |
| trendingB | ~$0.002 in CIRC. Aggregated trending Solana tokens across RugCheck organic, DexScreener boosts, and volume signals. |
| token_holdersC | ~$0.005 in CIRC. Holder count + top-5/10/20 supply concentration (a key rug/whale signal). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose, from listing costs to providing token prices, holders, security audits, and trading signals. There is no overlap between tools; even the swarm-related tools (consensus and feed) target different outputs.
Tool names mostly follow a descriptive noun or compound noun pattern in snake_case (e.g., circuit_quote, live_prices, token_holders). A few single-word names like 'scan' and 'trending' are minor deviations but still clear and consistent in style.
With 10 tools, the set is well-scoped for a crypto data and signal server. Each tool provides distinct functionality without being overwhelming or sparse.
The tools cover essential operations for token analysis and trading signals: price, security, holders, trending, and swarm signals. Minor gaps exist, such as lack of historical data or direct trading capabilities, but the core domain is well covered.