signalis-mcp

MCP server for Signalis — pay-per-call global intelligence for AI agents. Read the current Master Intelligence digest (narratives, signals, markdown analysis), poll for new digests, and drill into the AI-business Pulse layer: active narratives with lifecycle stage and momentum, per-narrative detail with source attribution, historical narrative digests, and raw scraped content. Pay per call with USDC on Base via x402 — no signup, no accounts, no API keys.

• 5 free tools — no wallet, no API key (incl. digest feedback).
• 5 paid tools — flat per-call USD prices, settled in USDC on Base Mainnet via x402.

Try before you pay: the free get_sample tool returns a recent digest so you can learn the exact response shape first.

---

Quick start

Free tier (no wallet)

{
  "mcpServers": {
    "signalis": {
      "command": "npx",
      "args": ["-y", "signalis-mcp"]
    }
  }
}

You get get_brief, get_index, get_sample, get_latest, submit_feedback.

Paid tier (with wallet)

Add an EVM wallet private key (0x-prefixed) that holds USDC on Base Mainnet:

{
  "mcpServers": {
    "signalis": {
      "command": "npx",
      "args": ["-y", "signalis-mcp"],
      "env": { "PRIVATE_KEY": "0x..." }
    }
  }
}

The paid tools then settle each call automatically.

Install snippets

Claude Code:

claude mcp add signalis -- npx -y signalis-mcp
# with a wallet:
claude mcp add signalis --env PRIVATE_KEY=0x... -- npx -y signalis-mcp

Claude Desktop / Cursor: add the JSON block above to your MCP config (claude_desktop_config.json or .cursor/mcp.json).

---

Tools

Free tools

Tool	Endpoint	Description
get_brief	GET /v1/intelligence/brief	Current Master Intelligence brief — title, executive summary, sentiment.
get_index	GET /v1/intelligence/index	Poll target — current digest id, updatedAt, nextExpected.
get_sample	GET /v1/intelligence/sample	Recent digest sample showing the response structure.
get_latest	GET /v1/intelligence/latest	Full Master Intelligence Digest — narratives, signals, markdown analysis.
submit_feedback	POST /v1/intelligence/feedback	Submit quality feedback on a master digest.

Paid tools

Tool	Endpoint	Price (USD)	Description
get_intelligence_history	GET /v1/intelligence/history	$0.03	Historical Master Intelligence digests (1–168h lookback). Optional hours, limit.
get_pulse_narratives	GET /v1/pulse/narratives	$0.01	Active AI-business narratives with lifecycle stage and momentum.
get_pulse_narrative	GET /v1/pulse/narratives/{id}	$0.01	Narrative detail — content items and source attribution. Requires id.
get_pulse_digests	GET /v1/pulse/digests	$0.03	Historical AI-business narrative digests. Optional since.
get_pulse_content_recent	GET /v1/pulse/content/recent	$0.02	Raw scraped content items from the last 4 hours.

Prices are flat per call — no bundles, no entitlements.

---

How payments work (x402)

Signalis speaks the x402 exact scheme. The API's 402 advertises a Base (USDC, EIP-3009) rail; this MCP settles on Base:

1. The MCP requests a paid endpoint. With no payment, the API replies HTTP 402 with the accepted terms.
2. If PRIVATE_KEY is set, the MCP settles the call via the standard @x402/fetch V2 client and retries. If no key is set, the MCP returns the 402 price terms so you can see the cost without paying.
3. The API returns the data plus a payment block.

Compute-first, settle-after: Signalis computes the full answer before charging, so you are never billed for an error.

No accounts, no API keys — just a wallet with USDC on Base Mainnet.

---

Environment variables

Variable	Required	Description
PRIVATE_KEY	No	0x-prefixed wallet key with USDC on Base Mainnet. Required to pay the 5 paid tools on a live API. Free tools work without it; without a key the paid tools surface the 402 price terms.
SIGNALIS_API_URL	No	Override the API base URL (default https://api.signalis.dev).

---

Disclaimer

Signalis provides informational intelligence aggregated from public sources. It is not professional or financial advice and is provided as-is without warranty. See https://api.signalis.dev/terms.txt.

Docs for agents: https://api.signalis.dev/llms.txt · full: https://api.signalis.dev/llms-full.txt

---

License

MIT © jcislo