{
  "markdown": "# ⚡ xsignal\n\n**Pay-per-call data ingredients for AI agents on Base**, via x402 (USDC). The flagship is the one thing no other x402\nsignal does: **`get_intent` abstains** — it returns *\"no verdict\"* (and says so) when it isn't confident enough, instead\nof always answering and always charging. **3 free calls per wallet** to try, then from **$0.01**. Verify-only: never\nsigns or moves funds.\n\n## The tools (flagship first)\n| Tool / route | Price | What you get |\n|---|---|---|\n| **`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. |\n| **`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. |\n| `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. |\n| `get_signal` · `GET /signal?q=<topic>` | $0.01 | A scored (virality + freshness) and **cited** real-time X/social signal. |\n| `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. |\n| `POST /mcp` | — | MCP (streamable-http): `tools/list` discovers the 5 tools; a `tools/call` returns an x402 **payment pointer**. |\n| `GET /health` · `/.well-known/mcp.json` · `/.well-known/agent-card.json` · `/skill.md` | free | health + agent discovery + the installable skill (no data). |\n\n## Try it free (3 calls per wallet)\nAdd `?wallet=0xYourAddress` to any route for **3 free full results**, so you can evaluate quality before paying. After 3,\nthat wallet pays via x402.\n```bash\ncurl \"https://xsignal-production.up.railway.app/intent?addr=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed&min_confidence=0.5&wallet=0xYourAddr\"\n```\nThen run the example — a **watchlist alerter** that surfaces only the tokens confidently moving (and stays quiet on the rest):\n```bash\nWALLET=0xYourAddr node examples/watchlist-alerter.js\n```\n\n## Pay with x402 (beyond the free probe)\nThe first post-probe request returns **HTTP 402** with an `accepts` array (price in USDC, network `base`, `payTo`). Pay\nwith `x402-fetch`/`x402-axios` and a funded Base wallet, resubmit with the `X-PAYMENT` header, get the result. `/intent`\nis pay-first: you pay, then get a verdict **or** an honest abstain.\n\n## Safety\n**We never sign or move funds.** x402 means we *receive* USDC to `payTo`; payment is **verify-only** via a facilitator.\nSignals are scored from public X posts + public DEX data — *verify before acting; not financial advice.* Confidence is a\nmechanical heuristic, not a calibrated probability or a prediction.\n\n## Config (env)\n| Var | Purpose |\n|---|---|\n| `XSIGNAL_PAYTO` | address that receives USDC (public; no key). Default = the operator address. |\n| `XSIGNAL_PRICE_USD` / `XSIGNAL_BRIEF_PRICE_USD` / `XSIGNAL_INTENT_PRICE_USD` | per-call prices (default `0.01` / `0.05` / `0.01`) |\n| `XSIGNAL_PROBE_FREE` | free probe calls per wallet (default `3`) |\n| `X402_NETWORK` / `FACILITATOR_URL` | `base` (mainnet CDP, needs `CDP_API_KEY_ID`/`CDP_API_KEY_SECRET`) or `base-sepolia` (keyless x402.org) |\n| `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. |\n\n## Run\n```bash\nnpm start      # :4520\nnpm test       # full self-test suite (signal · tokenintel · brief · intent · x402 · sources · server)\n```\nZero **runtime** deps for the core (plain Node >=18); `@coinbase/x402` is used only for CDP-facilitator auth on mainnet.\n",
  "bytes": 3873,
  "sha": "b2266290a198084c8b683d46691feb159cb70f9b223397e192cb5f48314df5d8",
  "repo_slug": "philpof102-svg/xsignal",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_philpof102_svg_xsignal_5988affd/readme"
}