IP2Proxy Proxy Detection Micro-service Server for AI Agents - n8n Workflow

AI Developers looking to give LLMs real-time cybersecurity tooling.
Users needing proxy and VPN detection integrated directly into automated AI reasoning systems.
n8n users aiming to deploy custom, encapsulated API services using the MCP standard.
Security analysts automating threat intelligence workflows using n8n templates.

This specialized n8n workflow is engineered to bridge AI agents with the IP2Proxy API using n8n's Micro-service Communication Protocol (MCP). Utilizing this powerful n8n workflow template allows users to instantly expose advanced IP and proxy detection capabilities—identifying VPNs, TOR exit nodes, and data centers—as a tool accessible by Large Language Models (LLMs). This greatly enhances the capability of AI agents by providing critical, real-time threat intelligence. This solution leverages the unique architecture of the n8n node ecosystem to transform a standard REST API endpoint into an easily consumable, structured AI agent tool, defining one core operation: Check Proxy IP. If you are building AI applications, this robust n8n workflow is essential for integrating external services seamlessly.

The entire process is initiated by the custom MCP n8n trigger, designed to serve as the server endpoint for external AI agent requests.

1. AI Agent Request: The AI agent makes a request to the dedicated MCP URL provided by the n8n trigger, seeking to perform a 'Check Proxy IP' operation.


2. Trigger Activation: The IP2Proxy Proxy Detection MCP Server n8n trigger receives the incoming request and validates the operation call.


3. Data Extraction: The workflow flow immediately moves to the Check Proxy IP n8n node, an HTTP Request Tool. This n8n node utilizes the powerful $fromAI() expressions to dynamically extract required parameters, such as the target ip address and the necessary API key, directly from the structured payload provided by the AI agent.


4. API Call: The HTTP Request n8n node executes the call to the IP2Proxy service (https://api.ip2proxy.com/).


5. Response: The raw response from the external API is then routed back through the MCP n8n trigger and returned to the calling AI agent, maintaining the original API structure for the AI to interpret. This reliable n8n workflow ensures quick and accurate data transfer.

To start using this specific n8n workflow template, follow these steps:

1. Import the Workflow: Download the provided JSON and import it directly into your n8n instance using the 'Import from JSON' option.


2. API Key Setup: Review the Check Proxy IP n8n node. Although the key is dynamically provided by the AI agent via $fromAI('key', ...) for flexibility, ensure your AI agent is configured to send a valid IP2Proxy API key. Alternatively, you can modify this specific n8n node to use a fixed credential if preferred.


3. Activate the Server: Once configured, activate the n8n workflow by toggling the 'Active' switch in the top right corner.


4. Retrieve MCP URL: After activation, copy the webhook URL from the IP2Proxy Proxy Detection MCP Server n8n trigger.


5. Connect AI Agent: Use the copied URL to configure the custom tool definition within your AI agent framework (e.g., Langchain, OpenAI Assistant, etc.), pointing it to this new n8n workflow endpoint.

This compact n8n workflow template relies on specialized nodes for AI agent compatibility:

IP2Proxy Proxy Detection MCP Server (n8n trigger):
Function: Serves as the listener and primary entry point for AI agent tool requests, implementing the MCP specification. It defines the endpoint path (ip2proxy-proxy-detection-mcp). This is a crucial n8n trigger for AI integration.
Key Configuration: Defines the communication protocol and listens for instructions (in this case, for the 'Check Proxy IP' operation).

Check Proxy IP (n8n node - HTTP Request Tool):
Function: Executes the external API call to IP2Proxy to determine the nature of a given IP address (proxy, VPN, etc.). This core n8n node handles the business logic.
Key Configuration:
URL: https://api.ip2proxy.com/
Query Parameters: Uses dynamic expressions ($fromAI()) to populate package, ip, format, and key from the AI agent's request, ensuring maximum flexibility in this n8n workflow.