# APIHub MCP Server

  MCP server for [APIHub](https://apihub.io) — 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](https://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:

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

  ### APIHub CLI

  ```bash
  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.