cortex402-mcp

MCP server for CorteX402 — exposes pay-per-call x402 data products as Claude-callable tools. Settles in USDC on Base mainnet.

Tools

| Tool | Cost | Description | |---|---|---| | sanctions_screen | $0.50 USDC | OFAC/UN/EU/UK + 100+ sanctions lists. Name + DOB + country in, normalized match score with provenance out. Source: OpenSanctions. | | aviation_weather | $0.10 USDC | METAR + TAF + 24h forecast for ICAO airports (batch up to 10). Sources: NOAA AviationWeather + Open-Meteo. | | property_dossier | $2.00 USDC | US address → 50-field property + demographics + risk dossier. Currently in development (returns clean status, no payment taken). |

Install — Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cortex402": {
      "command": "npx",
      "args": ["-y", "cortex402-mcp"],
      "env": {
        "CORTEX402_WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Restart Claude Desktop. The three CorteX402 tools become available to Claude.

Install — Claude Code

claude mcp add cortex402 -- npx -y cortex402-mcp

Then set the env var in your shell or in the config file produced.

Wallet setup

You need a wallet with USDC on Base mainnet (NOT Base Sepolia, NOT Ethereum mainnet). The wallet's private key goes in the CORTEX402_WALLET_PRIVATE_KEY env var.

Easiest funding path:

1. Coinbase Wallet (self-custody app, not the exchange) → Buy crypto → USDC on Base network → debit card
2. ~$5 USDC gives ~50 sanctions checks or ~50 aviation queries
3. Export the private key from Coinbase Wallet (Settings → Show recovery phrase → derive key)

Or use any existing Base mainnet wallet that you control the private key for.

What happens per call

1. Claude decides one of the CorteX402 tools is relevant to your question
2. The MCP server constructs the request and calls the corresponding cortex402.vercel.app endpoint
3. The endpoint returns HTTP 402 with payment requirements
4. The MCP server signs an EIP-3009 USDC transfer authorization with your wallet
5. Coinbase's CDP-authenticated facilitator settles the transfer on Base mainnet
6. The endpoint returns the data + an on-chain transaction hash receipt
7. Claude formats and returns the data to you

Total time per call: ~3–4 seconds end-to-end. No accounts, no API keys, no monthly minimums.

Security

• Your private key is stored in your MCP client config and read via env var by this MCP server. The server never logs or transmits it.
• All payments happen wallet-to-wallet on Base mainnet. No platform takes a cut.
• Each successful call returns a Base mainnet transaction hash, permanently auditable.

Endpoints + receiving wallets (canonical)

• Sanctions: 0x8A74c239DeDc0bB9Ee68eAEeC168Cca985f82F58
• Aviation: 0x41a90Fc1D1D7FE22aCc8aB1DdB978ed65205C56F
• Property: 0x420999608f6f05a007a89EAa77BcE8D81bd3Ae4B

All on Base mainnet. View any of them on https://basescan.org/.

Links

• Catalog page: https://innovativeblockchainsolutions.live/CorteX402/
• Machine-readable manifest: https://cortex402.vercel.app/.well-known/skill.md
• Source: https://github.com/Ooak21/cortex402
• x402 protocol spec: https://x402.org

License

MIT. Built by Innovative Blockchain Solutions.