@signalbench/mcp-server

Model Context Protocol (MCP) server for Signal Bench — agent-native access to macro composites, surprise indices, regime data, alerts, and daily digests.

Lets any MCP-compatible AI agent (Claude Desktop, Cursor, Cline, Continue, custom) read Signal Bench data as a first-class tool.

Install

You need a free Signal Bench API key first: https://www.signalbench.dev/settings/api-keys

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "signalbench": {
      "command": "npx",
      "args": ["-y", "@signalbench/mcp-server"],
      "env": {
        "SIGNALBENCH_API_KEY": "sb_yourkeyhere"
      }
    }
  }
}

Restart Claude Desktop. Signal Bench tools appear in the tools menu.

Cursor

Settings → Features → Model Context Protocol → Add new MCP server:

{
  "command": "npx",
  "args": ["-y", "@signalbench/mcp-server"],
  "env": {
    "SIGNALBENCH_API_KEY": "sb_yourkeyhere"
  }
}

Cline / Continue / other MCP hosts

Any host that supports stdio-transport MCP servers can run this binary. The command is npx -y @signalbench/mcp-server with the SIGNALBENCH_API_KEY env var set.

Available tools

| Tool | What it returns | |---|---| | signalbench_list_signals | Full catalog of composite + momentum signals with latest values | | signalbench_get_signal | Detail for one signal: definition, history, drivers, validation | | signalbench_get_digest | Today's "what changed" — biggest movers, regime shifts, warnings | | signalbench_get_alerts | Active alerts: threshold breaches, regime shifts, deteriorations | | signalbench_get_regimes | Overall risk posture + per-category regime scores | | signalbench_get_surprise_current | US Macro / Growth / Inflation trend-surprise indices | | signalbench_get_surprise_history | Historical timeseries for surprise indices | | signalbench_get_relationships | Cross-market correlation pairs with stability metadata | | signalbench_get_health | Data freshness, ingestion status, validation status | | signalbench_get_manifest | Full Signal Bench API manifest for further discovery |

Configuration

| Env var | Default | Purpose | |---|---|---| | SIGNALBENCH_API_KEY | required | Your Signal Bench API key | | SIGNALBENCH_BASE_URL | https://www.signalbench.dev | Override for testing against a preview deployment |

Pricing & tier access

Some tools (regimes, relationships, alerts, surprise) require Standard tier or higher. The MCP server uses your API key's tier automatically; tier limits are enforced by the Signal Bench API, not this client.

See https://www.signalbench.dev/pricing for tier details.

Example agent prompts

Once installed, your agent can answer prompts like:

• "What's the current US macro regime?"
• "Did the equity regime flip today?"
• "Summarize the macro surprise index for the past week"
• "Which signals deteriorated in this morning's digest?"
• "Show me the credit stress composite's recent history"

The agent picks the right tool, the tool returns JSON, the agent explains it in plain English in its own voice.

License

MIT. See https://www.signalbench.dev/docs for full terms.