nsgoods-mcp

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