signalis-mcp
MCP server for Signalis — pay-per-call global intelligencefor AI agents. Read the current Master Intelligence digest (narratives, signals, markdownanalysis), poll for new digests, and drill into the AI-business Pulse layer: activenarratives with lifecycle stage and momentum, per-narrative detail with source attribution,historical narrative digests, and raw scraped content. Pay per call with USDC onBase 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 theexact 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 aBase (USDC, EIP-3009) rail; this MCP settles on Base:
- The MCP requests a paid endpoint. With no payment, the API replies HTTP 402 with theaccepted terms.
- If
PRIVATE_KEYis set, the MCP settles the call via the standard@x402/fetchV2client and retries. If no key is set, the MCP returns the 402 price terms so you cansee the cost without paying. - The API returns the data plus a
paymentblock.
Compute-first, settle-after: Signalis computes the full answer before charging, soyou 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 notprofessional or financial advice and is provided as-is without warranty. Seehttps://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
