English Français العربية

io.github.philpof102-svg/xsignal

Official registry AI and agents

x402 pay-per-call data tools for Base agents. Flagship get_intent ABSTAINS instead of guessing.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http xsignal 'https://xsignal-production.up.railway.app/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "xsignal": {
            "type": "http",
            "url": "https://xsignal-production.up.railway.app/mcp"
        }
    }
}
NPM package @rakshasar/xsignal
Claude Code 
claude mcp add xsignal -e 'XSIGNAL_WALLET=<XSIGNAL_WALLET>' -- npx -y @rakshasar/xsignal@0.2.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "xsignal": {
            "command": "npx",
            "args": [
                "-y",
                "@rakshasar/xsignal@0.2.1"
            ],
            "env": {
                "XSIGNAL_WALLET": "<XSIGNAL_WALLET>"
            }
        }
    }
}

Environment variables

  • XSIGNAL_WALLET Your 0x Base address for 3 free calls per wallet; beyond that the tools return an x402 pay pointer.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ⚡ xsignal
  2. The tools (flagship first)
  3. Try it free (3 calls per wallet)
  4. Pay with x402 (beyond the free probe)
  5. Safety
  6. Config (env)
  7. Run

⚡ 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 / routePriceWhat you get
get_preflight · GET /preflight?addr=0x…$0.05The 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.01An 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.05A meal: fuses market intel + cited social signal into a "what is happening with $TOKEN now" brief.
get_signal · GET /signal?q=<topic>$0.01A scored (virality + freshness) and cited real-time X/social signal.
get_token_intel · GET /token?addr=0x…$0.01Base 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.mdfreehealth + 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.

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):

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)

VarPurpose
XSIGNAL_PAYTOaddress that receives USDC (public; no key). Default = the operator address.
XSIGNAL_PRICE_USD / XSIGNAL_BRIEF_PRICE_USD / XSIGNAL_INTENT_PRICE_USDper-call prices (default 0.01 / 0.05 / 0.01)
XSIGNAL_PROBE_FREEfree probe calls per wallet (default 3)
X402_NETWORK / FACILITATOR_URLbase (mainnet CDP, needs CDP_API_KEY_ID/CDP_API_KEY_SECRET) or base-sepolia (keyless x402.org)
X_BEARER_TOKEN or XAI_API_KEYlive X/Grok source for get_signal (token intel + intent are keyless via DexScreener). No key → a labelled DEMO seed.

Run

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.

Frequently asked questions

What is io.github.philpof102-svg/xsignal?

x402 pay-per-call data tools for Base agents. Flagship get_intent ABSTAINS instead of guessing.

How do I install io.github.philpof102-svg/xsignal?

It runs as a remote server. In Claude Code: claude mcp add --transport http xsignal 'https://xsignal-production.up.railway.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.philpof102-svg/xsignal need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.philpof102-svg/xsignal open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.philpof102-svg/xsignal?

It is published by philpof102-svg. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.