# SignalPulse MCP Server

**Hosted MCP server** for market intelligence with a public, machine-graded track record —
FX, crypto, futures, options, equities, sports, racing, and prediction markets.

- **Endpoint:** `https://signalpulse.theaslangroupllc.com/api/mcp`
- **Transport:** Streamable HTTP (stateless, POST JSON-RPC 2.0 — no session, no SSE required)
- **Auth:** none required for free tools. Paid tools take an `X-API-KEY` header (credit packs)
  **or** per-call [x402](https://x402.org) USDC micropayments on Base — fully agent-native,
  no signup needed.

## Why this one

Most market MCP servers are free data plumbing. SignalPulse sells **graded calls**: every paid
tool returns either the single highest-probability trade call for a market or a full analyst
report — and the engine's history is public and machine-graded (R-multiple ROI, win rate,
calibration buckets) via the free `track_record` tool, so an agent can verify performance
before spending anything.

## Tools (47)

**Free (no auth):**

| tool | what it returns |
|---|---|
| `track_record` | the public verifiable record: graded picks, win rate, R-multiple ROI, calibration |
| `leaderboard` | every desk's machine-graded record, daily/weekly/monthly |
| `instruments` | discovery: all instruments, sports, categories + per-tool parameter docs |
| `scan_sample` | pick-of-the-day: a full-depth free sample of the sports engine |
| `quote` | cost preview for any tool: credit type, USD range, and (with X-API-KEY) whether your balance covers it — never deducts a credit |

**Paid (1 credit or x402 per call):** `analysis` (any natural-language market question →
analyst report) plus scanners/signal desks: `scan_forex`, `scan_market`, `scan_crypto`,
`scan_crypto_lite`, `scan_futures`, `scan_event`, `scan_predmarket`, `scan_game`, `scan_racing`,
`scan_golf`, `signal_sports`, `signal_polymarket`, `signal_racing`, `signal_equities`,
`signal_stormy`, `signal_rainy`, `signal_screener`, `signal_tokenized`, and more — call
`instruments` for the full roster (or `tools/list`; the roster is generated from the live
endpoint manifest, so it is always current).

Every paid tool declares its credit type in its description and in `_meta["signalpulse/cost"]`
on `tools/list`, the free `quote` tool previews the exact cost before a call, and an uncredentialed call
returns the structured 402 payment envelope with the exact USDC price **before** anything is
charged — an agent never discovers pricing by losing a credit. Spec-safe: notification-form
`tools/call` (no `id`) is never executed (no silent credit burn).

## Connect

Claude Desktop / any streamable-HTTP client:

```json
{
  "mcpServers": {
    "signalpulse": {
      "url": "https://signalpulse.theaslangroupllc.com/api/mcp",
      "headers": { "X-API-KEY": "sp_YOURKEY" }
    }
  }
}
```

Works without the header too: free tools respond, paid tools return a structured x402 402
payment envelope (pay USDC out-of-band at the resource URL, then retry, or buy a credit pack).

## Pricing

Credits are sold in packs (Stripe or crypto): analysis $1.00–$1.49/credit, signals
$1.70–$2.49/credit by pack size. x402 per-call prices ride the 402 envelope. Full details:
[llms.txt](https://signalpulse.theaslangroupllc.com/llms.txt).

## Notes

- Responses are market commentary/education with a canonical risk disclaimer — not financial
  advice. Trade at your own risk.
- This repo is the documentation surface for the hosted server; the engine itself is
  closed-source.