Xsignal

x402-paid X/social signal + Base token market intel for AI agents. Pay-per-call USDC, free preview.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Remote HTTP

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "xsignal": {
      "url": "https://xsignal-production.up.railway.app/intent?addr=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed&min_confidence=0.5&wallet=0xYourAddr"
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

⚡ xsignal

Pay-per-call data ingredients for AI agents on Base, via x402 (USDC). The flagship is the one thing no other x402 signal does: get_intent abstains — it returns "no verdict" (and says so) when it isn't confident enough, instead of always answering and always charging. 3 free calls per wallet to try, then from $0.01. Verify-only: never signs or moves funds.

The tools (flagship first)

Tool / route	Price	What you get
`get_preflight` · `GET /preflight?addr=0x…`	$0.05	The composed Base preflight: fuses on-chain safety (SAFE/WATCH/AVOID + rug flags, via MainStreet) with momentum into one verdict — GO / CAUTION / AVOID. Safety gates momentum, so it never green-lights a token that can rug.
`get_intent` · `GET /intent?addr=0x…&min_confidence=0.7`	$0.01	An outcome-priced momentum verdict (`gaining`/`fading`) only if confidence clears your bar, else a calibrated `abstain`. Paid answers carry a keyless tamper-evidence receipt.
`get_token_brief` · `GET /brief?addr=0x…`	$0.05	A meal: fuses market intel + cited social signal into a "what is happening with $TOKEN now" brief.
`get_signal` · `GET /signal?q=<topic>`	$0.01	A scored (virality + freshness) and cited real-time X/social signal.
`get_token_intel` · `GET /token?addr=0x…`	$0.01	Base token market data (liquidity/volume/price/age/flow + flags). Best as an input to the brief.
`POST /mcp`	—	MCP (streamable-http): `tools/list` discovers the 5 tools; a `tools/call` returns an x402 payment pointer.
`GET /health` · `/.well-known/mcp.json` · `/.well-known/agent-card.json` · `/skill.md`	free	health + agent discovery + the installable skill (no data).

Try it free (3 calls per wallet)

Add ?wallet=0xYourAddress to any route for 3 free full results, so you can evaluate quality before paying. After 3, that wallet pays via x402.

Terminal

curl "https://xsignal-production.up.railway.app/intent?addr=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed&min_confidence=0.5&wallet=0xYourAddr"

Then run the example — a watchlist alerter that surfaces only the tokens confidently moving (and stays quiet on the rest):

bash

WALLET=0xYourAddr node examples/watchlist-alerter.js

Pay with x402 (beyond the free probe)

The first post-probe request returns HTTP 402 with an accepts array (price in USDC, network base, payTo). Pay with x402-fetch/x402-axios and a funded Base wallet, resubmit with the X-PAYMENT header, get the result. /intent is pay-first: you pay, then get a verdict or an honest abstain.

Safety

We never sign or move funds. x402 means we receive USDC to payTo; payment is verify-only via a facilitator. Signals are scored from public X posts + public DEX data — verify before acting; not financial advice. Confidence is a mechanical heuristic, not a calibrated probability or a prediction.

Config (env)

Var	Purpose
`XSIGNAL_PAYTO`	address that receives USDC (public; no key). Default = the operator address.
`XSIGNAL_PRICE_USD` / `XSIGNAL_BRIEF_PRICE_USD` / `XSIGNAL_INTENT_PRICE_USD`	per-call prices (default `0.01` / `0.05` / `0.01`)
`XSIGNAL_PROBE_FREE`	free probe calls per wallet (default `3`)
`X402_NETWORK` / `FACILITATOR_URL`	`base` (mainnet CDP, needs `CDP_API_KEY_ID`/`CDP_API_KEY_SECRET`) or `base-sepolia` (keyless x402.org)
`X_BEARER_TOKEN` or `XAI_API_KEY`	live X/Grok source for `get_signal` (token intel + intent are keyless via DexScreener). No key → a labelled DEMO seed.

Run

Terminal

npm start      # :4520
npm test       # full self-test suite (signal · tokenintel · brief · intent · x402 · sources · server)

Zero runtime deps for the core (plain Node >=18); @coinbase/x402 is used only for CDP-facilitator auth on mainnet.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Xsignal

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "xsignal": { "command": "npx", "args": ["-y", "xsignal"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/xsignal?style=directory)](https://allmcps.com/mcp/xsignal)

HTML Embed

<a href="https://allmcps.com/mcp/xsignal"><img src="https://allmcps.com/api/badge/xsignal?style=directory" alt="Xsignal on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

40Quality signal: Fair · 40/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Xsignal →Install in Claude Desktop Install in Cursor Install in VS Code

Documentation Overview

⚡ xsignal

The tools (flagship first)

Tool / route	Price	What you get
`get_preflight` · `GET /preflight?addr=0x…`	$0.05	The composed Base preflight: fuses on-chain safety (SAFE/WATCH/AVOID + rug flags, via MainStreet) with momentum into one verdict — GO / CAUTION / AVOID. Safety gates momentum, so it never green-lights a token that can rug.
`get_intent` · `GET /intent?addr=0x…&min_confidence=0.7`	$0.01	An outcome-priced momentum verdict (`gaining`/`fading`) only if confidence clears your bar, else a calibrated `abstain`. Paid answers carry a keyless tamper-evidence receipt.
`get_token_brief` · `GET /brief?addr=0x…`	$0.05	A meal: fuses market intel + cited social signal into a "what is happening with $TOKEN now" brief.
`get_signal` · `GET /signal?q=<topic>`	$0.01	A scored (virality + freshness) and cited real-time X/social signal.
`get_token_intel` · `GET /token?addr=0x…`	$0.01	Base token market data (liquidity/volume/price/age/flow + flags). Best as an input to the brief.
`POST /mcp`	—	MCP (streamable-http): `tools/list` discovers the 5 tools; a `tools/call` returns an x402 payment pointer.
`GET /health` · `/.well-known/mcp.json` · `/.well-known/agent-card.json` · `/skill.md`	free	health + agent discovery + the installable skill (no data).

Try it free (3 calls per wallet)

Add ?wallet=0xYourAddress to any route for 3 free full results, so you can evaluate quality before paying. After 3, that wallet pays via x402.

Terminal

curl "https://xsignal-production.up.railway.app/intent?addr=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed&min_confidence=0.5&wallet=0xYourAddr"

Then run the example — a watchlist alerter that surfaces only the tokens confidently moving (and stays quiet on the rest):

bash

WALLET=0xYourAddr node examples/watchlist-alerter.js

Pay with x402 (beyond the free probe)

Safety

Config (env)

Var	Purpose
`XSIGNAL_PAYTO`	address that receives USDC (public; no key). Default = the operator address.
`XSIGNAL_PRICE_USD` / `XSIGNAL_BRIEF_PRICE_USD` / `XSIGNAL_INTENT_PRICE_USD`	per-call prices (default `0.01` / `0.05` / `0.01`)
`XSIGNAL_PROBE_FREE`	free probe calls per wallet (default `3`)
`X402_NETWORK` / `FACILITATOR_URL`	`base` (mainnet CDP, needs `CDP_API_KEY_ID`/`CDP_API_KEY_SECRET`) or `base-sepolia` (keyless x402.org)
`X_BEARER_TOKEN` or `XAI_API_KEY`	live X/Grok source for `get_signal` (token intel + intent are keyless via DexScreener). No key → a labelled DEMO seed.

Run

Terminal

npm start      # :4520
npm test       # full self-test suite (signal · tokenintel · brief · intent · x402 · sources · server)

Zero runtime deps for the core (plain Node >=18); @coinbase/x402 is used only for CDP-facilitator auth on mainnet.