Cortexcloud

io.github.jonahthan433Published by GitHub account jonahthan433v0.5.0Updated Oct 27, 2026

Pay-per-call on-chain data for AI agents: token, wallet, risk, whale, NFT, tx. No API keys.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Pay-per-call on-chain data MCP server: token, wallet, NFT, transaction, gas and risk lookups settled in USDC on Base, with no API keys.

What you can do
  • Look up token prices, ERC-20 balances, NFT ownership, transaction history, gas fees and blocks on supported chains
  • Profile wallets and scan for large transfers or accumulation activity
  • Assess token risk and build evidence-backed token profiles with source and timestamp per fact
  • Compare one contract across up to five chains in a single call
  • Batch balances, NFTs, prices and transfers for up to 20 addresses or 50 ids per call
  • Read the free capability and price tables without paying
When to use it
Useful when an assistant needs on-chain crypto data for research, due diligence or monitoring without signing up for provider API keys, and the caller is willing to pay small per-call USDC fees on Base.
Requirements
Remote Streamable HTTP endpoint, or the npm package run via npx as a stdio bridge to the same hosted server. No account or API key. Paid calls need an x402 USDC payment on Base: sign an EIP-3009 authorization and supply the payment-signature header, or set CORTEXCLOUD_PAYMENT_SIGNATURE for the stdio bridge. CORTEXCLOUD_BASE optionally overrides the API base.
Before you install
Most tools cost money: $0.004 to $0.040 USDC per call, and batch tools charge per address or id, so repeated or large batches spend real funds. Paid calls require signing a USDC authorization with a wallet; the server relays the payment-signature header and holds no funds. Queries and payment headers go to a third-party hosted API. Free tools are cortex_capabilities and cortex_prices.

Installation

In SourceWeft

  1. Open Cortexcloud in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jonahthan433%2Fcortexcloud/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "cortexcloud": {
      "type": "http",
      "url": "https://api.cortexcloud.org/mcp"
    }
  }
}

README

@cortexcloud.org/mcp

MCP server for CortexCloud — pay-per-call on-chain data and intelligence for AI agents. Token, wallet, risk, whale, balance, NFT, transaction and cross-chain reads, settled in USDC on Base over x402. No API keys, no subscriptions, no signup.

Two ways to connect

1. Remote (recommended). The hosted server speaks Streamable HTTP and is always current:

json
{  "mcpServers": {    "cortexcloud": {      "type": "http",      "url": "https://api.cortexcloud.org/mcp"    }  }}

2. stdio bridge. This package, for clients that can only launch a local process:

json
{  "mcpServers": {    "cortexcloud": {      "command": "npx",      "args": ["-y", "@cortexcloud.org/mcp"]    }  }}

The bridge is a transport adapter, not a second implementation: it forwards tools/list and tools/call to the hosted server, so tools, schemas and prices can never drift from the API.

Tools

17 tools, served from the live registry:

  • Paid (15) — cortex_token_intel ($0.030), cortex_cross_chain_compare ($0.040), cortex_whale_alerts ($0.030), cortex_token_risk ($0.020), cortex_wallet_intel ($0.006), and the $0.004 data routes: cortex_token_price, cortex_token_balances, cortex_nft_ownership, cortex_tx_history, cortex_gas_oracle, cortex_block, plus the batch tools cortex_aggregate_balances, cortex_aggregate_nfts, cortex_aggregate_prices, cortex_aggregate_tx_history (up to 20 items per call).
  • Free (2) — cortex_capabilities (every route, chain and price) and cortex_prices (the price table).

The authoritative list is always GET https://api.cortexcloud.org/v1/capabilities, or cortex_capabilities over MCP.

How payment works

A paid tool call without payment returns the x402 challenge inside the tool result: price, payee, asset, network, and the endpoint to call. Nothing is charged and no wallet is needed to read it.

To settle, the caller signs an EIP-3009 USDC authorization and replays the request with the payment-signature header. Over MCP the server relays that header to the API unchanged; it holds no funds and never signs. Over stdio, forward an existing signature with:

bash
CORTEXCLOUD_PAYMENT_SIGNATURE=<base64 header> npx -y @cortexcloud.org/mcp

For a complete paid flow from code, use the REST reference client — 402 -> sign -> 200 in one file:

https://api.cortexcloud.org/examples/paid_client.py

Env

VariableDefaultMeaning
CORTEXCLOUD_BASEhttps://api.cortexcloud.orgAPI base; the bridge connects to <base>/mcp
CORTEXCLOUD_PAYMENT_SIGNATURE—Optional x402 payment header forwarded on every call

Verified behaviour

  • initialize advertises protocol 2025-06-18; the upstream server reports version 0.5.0.
  • tools/list returns 17 tools.
  • cortex_capabilities returns the live catalog with no payment.
  • cortex_token_price without payment returns the 402 challenge, not an error.

Links

MIT licensed.

Source: README.md at commit e030967

Tools

17

cortex_token_balances

ERC-20 token balances for a wallet on a chain (Alchemy Token API). x402 paid: $0.004 USDC on Base per call.

Parameterschaintokensaddressrequiredmax_tokens

cortex_token_price

Spot USD price for a token/coin. Provide 'id' (CoinGecko id, e.g. 'ethereum', 'usd-coin') or 'contract'+'chain'. x402 paid: $0.004 USDC on Base per call.

Parametersidchaincontract

cortex_nft_ownership

NFTs owned by a wallet on a chain (Alchemy NFT API). x402 paid: $0.004 USDC on Base per call.

Parameterschainaddressrequiredpage_size

cortex_tx_history

Normalized transactions for an address on a chain (Alchemy Transfers API). x402 paid: $0.004 USDC on Base per call.

Parameterschainlimitaddressrequiredfrom_block

cortex_gas_oracle

Current base fee + priority fee (gas prices) for a chain (Alchemy). x402 paid: $0.004 USDC on Base per call.

Parameterschain

cortex_block

Block by number or 'latest' on a chain (Alchemy). x402 paid: $0.004 USDC on Base per call.

Parametersblockchain

cortex_token_risk

Token risk verdict (age, liquidity, contract checks, suspicious-transfer scan) with per-claim evidence. x402 paid: $0.020 USDC on Base per call.

Parameterschaincoin_idcontractrequired

cortex_wallet_intel

Wallet profile: balances, holdings, recent activity, counterparty relationships (Alchemy). x402 paid: $0.006 USDC on Base per call.

Parameterschainlimitaddressrequired

cortex_whale_alerts

Large-transfer / accumulation alerts with tx hashes + timestamps (Alchemy). Omit 'address' for a chain-wide scan. x402 paid: $0.030 USDC on Base per call.

Parameterschainlimitaddressmin_usd

cortex_cross_chain_compare

Compare one contract address across up to 5 chains (price, activity, deployment) in one call. x402 paid: $0.040 USDC on Base per call.

Parameterschainscontractrequired

cortex_token_intel

Flagship evidence-backed token profile in one call: deployment, metadata, spot price, 24h change, optional age/liquidity/market-cap, recent activity — every fact carries source + checked_at. x402 paid: $0.030 USDC on Base per call.

Parameterschaincoin_idcontractrequired

cortex_aggregate_balances

Batch ERC-20 balances for many addresses in one call (Alchemy). Priced per constituent lookup: $0.004 USDC per address (1-20 addresses).

Parameterschainaddressesrequired

cortex_aggregate_nfts

Batch NFT ownership across addresses in one call. Priced per constituent lookup: $0.004 USDC per address (1-20 addresses).

Parameterschainaddressesrequiredpage_size

cortex_aggregate_prices

Batch spot USD prices for many coins (CoinGecko). Priced per constituent lookup: $0.004 USDC per id (1-50 ids).

Parametersidsrequired

cortex_aggregate_tx_history

Batch normalized transfers across addresses in one call. Priced per constituent lookup: $0.004 USDC per address (1-20 addresses).

Parameterschainlimitaddressesrequired

cortex_capabilities

Free: service capabilities, supported chains/providers, payment terms and discovery index.

Takes no parameters.

cortex_prices

Free: complete tool/price table for this MCP gateway (served locally, no upstream call).

Takes no parameters.

Version history

2
  1. v0.5.0LatestOct 22, 2026
  2. v0.4.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts