ElfProxy Dynamic IP MCP server

ElfProxy MCP Server is a privacy-first infrastructure solution that combines dynamic IP rotation with AI-optimized web interaction capabilities. It enables secure, large-scale web data access for AI systems through the ElfProxy Dynamic IP Network and an Enhanced Model Context Protocol (MCP) layer.

Overview

The ElfProxy MCP Server integrates two powerful components:

• ElfProxy Dynamic IP Network: Global residential proxy infrastructure with country-level targeting, automatic IP rotation, TLS fingerprint masking, and multi-protocol support
• Enhanced Model Context Protocol (MCP): AI-specific web interaction layer featuring context-aware request scheduling, headless browser rendering, content sanitization, and adaptive rate limiting

Key Features

• Anonymity: IP/UserAgent/Canvas fingerprint rotation
• AI Optimization: Content extraction with conversion to Markdown/JSON/Plaintext
• Geo-Targeting: Country/City/ASN-level location simulation
• Security: End-to-end HTTPS encryption with request timestamp obfuscation
• Reliability: 99.99% SLA with automatic proxy blacklisting

Prerequisites

Before getting started, you need:

• ElfProxy Account: Register an account at ElfProxy, contact ElfProxy customers, and obtain an apiKey (200MB of data is available for trial use)

Installation

Building from Source

mvn clean package

Running the Server

java -jar target/proxy-pool-server-{version}.jar

Configuration

Server Configuration

Configure your apiKey in the application.yml file. This key is obtained from your ElfProxy account.

Cursor Tool Configuration

To use this MCP server with Cursor, add the following to your Cursor settings:

{
  "proxy-pool-server": {
    "url": "http://localhost:9000/sse",
    "enabled": true
  }
}

Usage

API Endpoints

The server exposes the following MCP tool:

• getProxy: Retrieves an IP address from the proxy pool. Use the 'code' field to specify which country's code you need.

Example Queries

When used with Claude, you can make requests such as:

• "Please extract a proxy IP address from the United States for me"
• "Accessing through a US proxy IP using puppeteer https://www.amazon.de"

These queries will leverage the MCP server to provide proxied access to web resources with appropriate geolocation targeting.

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.