@agent-signal/mcp

MCP server for AgentSignal — live LONG/FLAT/SHORT trading signals, COMPASS macro score, RADAR calendar risk, and backtests for AI agents. Paid tools settle automatically via x402 micropayments in USDC on Base — no API key, no subscription.

Source: github.com/ToknWrks/agentsignal (this package lives at packages/mcp in the AgentSignal monorepo). For the standalone desktop app that executes trades against an exchange, see github.com/ToknWrks/trader — a separate project.

Install

claude mcp add agentsignal \
  --command npx \
  --args "-y @agent-signal/mcp@latest"

Or add it directly to your MCP client config:

{
  "mcpServers": {
    "agentsignal": {
      "command": "npx",
      "args": ["-y", "@agent-signal/mcp@latest"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Environment variables

| Variable | Required | Description | |---|---|---| | AGENT_PRIVATE_KEY | Only for paid tools | 0x-prefixed EVM private key, funded with USDC on Base. Used to sign x402 payments locally — never sent to AgentSignal. Free tools (list_strategies, get_compass, get_radar, get_crypto_radar, get_signal_history, get_latest_report) work without it. | | AGENTSIGNAL_URL | No | Override the API base URL. Defaults to https://agentsignal.app. |

Without AGENT_PRIVATE_KEY, calling a paid tool returns an HTTP 402 error from AgentSignal rather than failing locally — you'll see the price in the error message.

Tools

| Tool | Cost | Description | |---|---|---| | get_signal | $0.01 via x402 | Live LONG/FLAT/SHORT signal for a saved strategy — direction, price, COMPASS score, per-condition results. | | run_backtest | $0.05 via x402 | Full historical backtest — return, alpha, Sharpe, Sortino, max drawdown, win rate, trade log. | | list_strategies | Free | List public template strategies. | | get_compass | Free | Latest COMPASS macro risk-on/off score (-7 to +7). | | get_radar | Free | Latest RADAR calendar risk score (FOMC/CPI proximity). | | get_crypto_radar | Free | AI-generated crypto market risk assessment. | | get_signal_history | Free | Last 30 days of stored signals for a strategy. | | get_latest_report | Free | Today's full market analyst report. | | get_premium_fade_signals | $0.10 via x402 | Premium fade options signals for a ticker. | | update_premium_fade_pos | Free | Close/update a premium fade position. |

Full parameter schemas are exposed via MCP tools/list — any MCP client will show them directly.

How x402 payment works here

1. A paid tool call hits an AgentSignal endpoint that requires payment.
2. This server catches the HTTP 402 response, signs an EIP-3009 USDC authorization with AGENT_PRIVATE_KEY via viem, and retries the request using @x402/core + @x402/evm.
3. Coinbase's CDP facilitator settles the transfer on Base mainnet (eip155:8453). The tool call returns once payment clears — typically 1–3 seconds.

Your agent's model never sees or reasons about the private key or the payment flow — it just calls a tool and gets data back.

License

MIT