{
  "markdown": "# @cortexcloud/mcp\n\nMCP server for the **CortexCloud API** — pay-per-call AI generation, data and RPC endpoints through the [x402](https://x402.org) protocol. No API keys, no subscriptions; every tool call is billed in **USDC on Base** and settles to the operator's wallet.\n\n## Quick start (hosted)\n\nNo install required — point any MCP client at the public Streamable HTTP endpoint:\n\n```\nhttps://api.cortexcloud.org/mcp\n```\n\nYour MCP client handles the x402 payment handshake automatically; each call pays from the wallet your agent is authorized to spend.\n\n## Running it yourself\n\n### Streamable HTTP server (like the hosted one)\n\n```bash\nnpm run build\nEVM_PRIVATE_KEY=0x... node dist/http.js      # signs + pays calls; defaults to port 3200\n# listening on http://localhost:3200/mcp\n```\n\n| Env | Default | Meaning |\n|-----|---------|---------|\n| `EVM_PRIVATE_KEY` | — | Wallet that signs + pays each x402 call. **Required.** |\n| `PORT` | `3200` | HTTP listen port |\n| `CORTEXCLOUD_URL` | `https://api.cortexcloud.org` | Upstream CortexCloud API base |\n| `CORTEXCLOUD_PAYTO` | `\"0x5a03…ea143\"` | Wallet where call revenue settles |\n\n### stdio (Claude Desktop / CLI)\n\n```json\n{\n  \"mcpServers\": {\n    \"cortexcloud\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cortexcloud/mcp\"],\n      \"env\": { \"EVM_PRIVATE_KEY\": \"0x...\" }\n    }\n  }\n}\n```\n\n## Tools (22)\n\n**AI** — `chat_completions` `responses` `embeddings` `models` `image_generation` `text_to_speech`\n**Search & news** — `web_search` `search_contents` `news`\n**Market/data** — `prices` `coins_search` `crypto_history` `fx_list` `fx_price` `defi_yields` `defi_protocols`\n**Chain** — `base_balance` `base_token_balance` `eth_balance` `ethereum_rpc` `dex_search` `dex_pairs`\n\nSchema for every tool is exposed via MCP's `tools/list` — no docs drift, what a client sees is what runs.\n\n## How x402 works under the hood\n\nEach 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.\n\n## License\n\nMIT",
  "bytes": 2258,
  "sha": "826fc6c143bcef620260e162afe1f57bc2f983ac700b84ce7676e84cc5a08540",
  "repo_slug": "jonahthan433/cortexcloud-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jonahthan433_cortexcloud_4749b0fa/readme"
}