mcp-server

APIHub MCP Server

MCP server for APIHub — discover and call paid APIs with USDC credits. No wallet, no gas, no per-provider SDKs.

• Hosted endpoint: https://mcp.apihub.io/mcp
• Transport: Streamable HTTP
• Protocol version: 2025-03-26
• Auth: Bearer token (get a free key at apihub.io)

Tools

| Tool | Description | |------|-------------| | apihub_search | Search for APIs by capability, category, or price range | | apihub_list_services | List available onboarded API services | | apihub_get_service | Fetch full details for a specific service | | apihub_call | Make a paid API call through the proxy (debits credits) | | apihub_search_external | Search the external x402 catalog | | apihub_call_external | Call any external x402 API via credits | | apihub_read_content | Fetch and parse a web page through a paid content gateway | | apihub_topup | Get payment instructions to top up your credit balance | | apihub_balance | Check your credit balance and spending history |

Quick start

Claude Desktop / Cursor / Codex

Add to your MCP config:

  {
    "mcpServers": {
      "apihub": {
        "url": "https://mcp.apihub.io/mcp",
        "headers": {
          "Authorization": "Bearer ahk_your_api_key"
        }
      }
    }
  }

APIHub CLI

  npx @apihubio/cli install    # writes the MCP config for you
  npx @apihubio/cli register   # get an API key
  npx @apihubio/cli topup 10   # fund with $10 USDC

Why credits instead of per-call x402

• Gasless: pay on-chain once when topping up, not per request
• Walletless: no USDC, no EIP-3009 signing, no gas
• Works in any MCP client: just a Bearer token header
• Instant: D1 debit at the edge, no block confirmations per call

Learn more

• MCP documentation: https://apihub.io/docs/agents/mcp
• CLI documentation: https://apihub.io/docs/agents/cli
• Full docs: https://apihub.io/docs
• Provider onboarding: https://apihub.io/docs/providers/onboarding
• Base x402 protocol: https://x402.org

License

The hosted service is operated by APIHub. This repository contains integration documentation only.