home / mcp / apollo proxy mcp server

Apollo Proxy MCP Server

Provides web fetching via Apollo’s residential proxy network with pay-per-use access for MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bnmbnmai-mcp-proxy": {
      "command": "npx",
      "args": [
        "@apollo_ai/mcp-proxy"
      ],
      "env": {
        "APOLLO_API_URL": "https://apolloai.team"
      }
    }
  }
}

Apollo Proxy MCP Server provides web fetching capabilities through Apollo’s residential proxy network, enabling AI agents to access the web with pay-per-use microtransactions. It is designed for fast integration with MCP clients and supports rotating or sticky IP behavior across 190+ countries.

How to use

You will run the MCP server as a local (stdio) process that your MCP client can invoke. Start by installing the package, then configure your MCP client to launch the proxy server as an external tool. Use the server to fetch web content, check service status, and explore available exit countries. Your agent pays per request using the x402 protocol with a USDC wallet on Base.

How to install

Prerequisites: Node.js 18+ and an MCP-compatible client such as Claude Desktop or Cursor.

npm install -g @apollo_ai/mcp-proxy

Configuration and usage notes

To run the proxy from an MCP client, configure the client to execute the provided command. The following configuration demonstrates how to launch the proxy with a standard MCP client. Include the environment variable for the API endpoint if you need to override the default.

{
  "mcpServers": {
    "apollo-proxy": {
      "command": "npx",
      "args": ["@apollo_ai/mcp-proxy"]
    }
  }
}

Runtime environment and billing considerations

The service charges $0.005 per request. You can monitor status and pricing using the provided tools. Payments are handled via the x402 protocol, requiring a USDC wallet on Base mainnet.

Tools

The MCP server exposes three core tools you can invoke from your MCP client:

Tool: proxy_fetch

Fetch any URL through residential proxies. You can specify the target URL, country code, HTTP method, and session type to control IP rotation.

Tool: proxy_status

Check service availability and current pricing for proxy requests.

Tool: list_countries

List available proxy exit countries by region to help you select an appropriate locale for your fetch.

Environment variables

You can override the default API endpoint using an environment variable.

Use cases

Web scraping, geo-restricted content access, API data retrieval, and market research are common scenarios you can enable with the proxy-enabled MCP setup.

Supported countries and regions

The proxy network supports exits from Americas, Europe, Asia, Africa, and Oceania. Refer to the available country lists within the tool outputs to pick a suitable exit country.

Available tools

proxy_fetch

Fetch any URL through residential proxies with configurable country, method, and session type.

proxy_status

Check service availability and pricing for the proxy service.

list_countries

List available proxy exit countries grouped by region.