nsgoods-mcp

Unified MCP server for the nsgoods x402 oracle suite — the verifiable trust layer for AI agents. It exposes every paid endpoint of the five nsgoods services as MCP tools (plus a free preview for each), and pays per call in USDC on Base via the x402 protocol.

| Service | Subdomain | Tools | |---|---|---| | Kraken Crypto Signals | signals.nsgoods.org | signals, signals_top, indicators, regime_changed, history, backtest | | Agent Trust Oracle (ERC-8004) | trust.nsgoods.org | agent_trust | | CMC Regime Skill | regime.nsgoods.org | regime | | Extractability Oracle (web/GEO) | schema.nsgoods.org | extractability, extractability_html | | Solar Legality Oracle | solar.nsgoods.org | solar_legality, solar_legality_all | | Free previews | — | signals_preview, trust_preview, regime_preview, extractability_preview, solar_preview |

Every paid answer is ECDSA-signed and appended to a public, tamper-evident hash chain, so an agent can verify authenticity before trusting it.

How payment works

Payment is automatic. When a paid endpoint returns HTTP 402, @x402/axios signs a USDC payment on Base with your wallet and retries — no accounts, no API keys. You only pay for the paid tools; every *_preview tool is free and needs no wallet.

Set EVM_PRIVATE_KEY to a low-balance Base hot wallet with a little USDC to enable the paid tools. Without it, the server still runs and the previews work; paid tools return a friendly "set EVM_PRIVATE_KEY" message.

Install / run

npm install -g nsgoods-mcp
EVM_PRIVATE_KEY=0x... nsgoods-mcp   # stdio MCP server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "nsgoods": {
      "command": "npx",
      "args": ["-y", "nsgoods-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0xYOUR_BASE_WALLET_KEY" }
    }
  }
}

Omit EVM_PRIVATE_KEY to use only the free preview tools.

Security

EVM_PRIVATE_KEY is a spending key. Use a dedicated, low-balance Base wallet funded with only what you intend to spend. Never commit it. Prices per call range from $0.005 to $0.25 (see each tool description).

License

MIT © Nikoble1926