@cortexcloud/mcp

MCP server for the CortexCloud API — pay-per-call AI generation, data and RPC endpoints through the x402 protocol. No API keys, no subscriptions; every tool call is billed in USDC on Base and settles to the operator's wallet.

Quick start (hosted)

No install required — point any MCP client at the public Streamable HTTP endpoint:

https://api.cortexcloud.org/mcp

Your MCP client handles the x402 payment handshake automatically; each call pays from the wallet your agent is authorized to spend.

Running it yourself

Streamable HTTP server (like the hosted one)

npm run build
EVM_PRIVATE_KEY=0x... node dist/http.js      # signs + pays calls; defaults to port 3200
# listening on http://localhost:3200/mcp

Env	Default	Meaning
EVM_PRIVATE_KEY	—	Wallet that signs + pays each x402 call. Required.
PORT	3200	HTTP listen port
CORTEXCLOUD_URL	https://api.cortexcloud.org	Upstream CortexCloud API base
CORTEXCLOUD_PAYTO	"0x5a03…ea143"	Wallet where call revenue settles

stdio (Claude Desktop / CLI)

{
  "mcpServers": {
    "cortexcloud": {
      "command": "npx",
      "args": ["-y", "@cortexcloud/mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x..." }
    }
  }
}

Tools (22)

AI — chat_completions responses embeddings models image_generation text_to_speech Search & news — web_search search_contents news Market/data — prices coins_search crypto_history fx_list fx_price defi_yields defi_protocols Chain — base_balance base_token_balance eth_balance ethereum_rpc dex_search dex_pairs

Schema for every tool is exposed via MCP's tools/list — no docs drift, what a client sees is what runs.

How x402 works under the hood

Each call performs an x402 HTTP exchange against the CortexCloud API: request → payment challenge → signed TransferWithAuthorization → valid data. The SDK core handles the handshake; @x402/evm builds + signs the transfer; @x402/fetch drives the HTTP loop. Money in is trustless — cold settlement on-chain, no API-key storage, no subscriptions, no per-seat licensing.

License

MIT