MCP (Model Context Protocol) is becoming the standard way to give AI agents access to external tools. If you're using Claude Desktop, Cursor, or any MCP-compatible client, you can add Proxagora in under five minutes and give your agent access to 30+ APIs — weather, crypto, geo, web scraping, and more — paid per call via USDC.

This is a complete walkthrough.

Prerequisites

An MCP-compatible client (Claude Desktop, Cursor, Windsurf, etc.)
A Base wallet with some USDC (or use Stripe card payments instead)
Node.js 18+

Step 1: Fund Your Account

You have two options:

Option A: USDC on Base — Send USDC to your wallet address on Base. This is the native payment method and has no platform fee beyond the per-call price.

Option B: Stripe card — Buy credits at proxagora.com/dashboard. Credits are stored in your Proxagora account and debited per call. No crypto wallet needed.

Step 2: Install the MCP Package

npx proxagora-mcp

Or install globally:

npm install -g proxagora-mcp
proxagora-mcp

The server starts on stdio by default — which is what MCP clients expect.

Step 3: Configure Your MCP Client

Claude Desktop

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

{
  "mcpServers": {
    "proxagora": {
      "command": "npx",
      "args": ["proxagora-mcp"],
      "env": {
        "PROXAGORA_WALLET": "0xYourWalletAddress",
        "PROXAGORA_PRIVATE_KEY": "0xYourPrivateKey"
      }
    }
  }
}

If you're using Stripe credits instead of a wallet, use:

{
  "env": {
    "PROXAGORA_API_KEY": "your-proxagora-api-key"
  }
}

Cursor

Add the same config to .cursor/mcp.json in your project root, or globally in ~/.cursor/mcp.json.

Step 4: Restart and Test

Restart your MCP client. The Proxagora tools should now appear. You can test by asking your agent:

"What's the current weather in Bangkok?"

The agent will:

Call the Proxagora discover tool to find weather APIs
Select the best match
Pay per x402 or deduct from Stripe credits
Return the result

What APIs Are Available?

The MCP server dynamically loads available APIs from Proxagora at startup. Current categories include:

Weather — current conditions, forecasts, historical
Crypto — prices, on-chain data, DeFi protocol stats
Geo — IP geolocation, timezone lookup, country data
Web — scraping, screenshot, metadata extraction
Finance — stock quotes, forex rates, economic indicators
Identity — email validation, phone lookup, WHOIS

New APIs are added regularly by third-party providers. The MCP server picks them up automatically on restart.

Dynamic Tool Loading

One of the more interesting things about proxagora-mcp is that it doesn't hardcode any tools. At startup, it calls /api/discover and registers every available API as a separate MCP tool — with the API's description, parameters, and pricing exposed to the agent.

This means your agent can reason about which API to use and what it'll cost before making the call. It can compare two weather providers and pick the cheaper one, or pick the one with higher reputation, or pick the one that has the specific data format it needs.

Tools aren't static. They grow as the marketplace grows.

Source Code

The MCP package is open source: github.com/sideEyeLabs/proxagora-mcp.

PRs welcome — especially for new language SDKs and client integrations.