ElfProxy

You deploy and run the ElfProxy MCP Server to access and extract proxy IPs for AI-driven web interactions. This MCP server combines a dynamic IP network with an intelligent Model Context Protocol layer, enabling secure, geo-targeted proxy usage, content sanitization, and adaptive request handling for large-scale data tasks.

How to use

After you start the ElfProxy MCP Server, you can request proxy IPs through the MCP client. The server exposes a getProxy tool that retrieves an IP from the pool and signals the country code you want. You can then perform actions through the specified proxy, such as browsing targeted websites or streaming content with automated IP, header, and protocol rotation to maintain anonymity.

How to install

Prerequisites you need to have before installation are an ElfProxy account to obtain an API key, Java installed to run the MCP server, and a Java build tool if you plan to build from source.

mvn clean package

Run the built MCP server using Java. The exact jar name will be produced by the build process. Start the server with the standard Java execution command.

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

Additional content

Configuration notes, security practices, example MCP URL/command patterns, and troubleshooting tips follow in this section to help you deploy smoothly and securely.

Configuration

You can configure the MCP client to connect to the proxy pool server. The following example shows how Cursor can be configured to subscribe to the MCP server endpoints for getting proxy details.

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

Available tools

getProxy

Retrieve a proxy IP from the pool and indicate the desired country code. The MCP tool handles IP selection and provides the corresponding IP for use in subsequent requests.