Docs/Quickstart/MCP

MCP — Claude Code & Agent SDK

Connect your agent to AixIps in five minutes with one MCP server entry. Your agent gets fetch_url, create_persona and get_usage tools — no proxy lists, no IP management.

1Prerequisites

You need Node.js 18+ and an AixIps API key. Create a free key in the console — the snippets below use the placeholder sk_test_xxx.

2Install the MCP server

With Claude Code, one command registers the server. No global install is needed — npx fetches it on demand.

Claude Code

claude mcp add aixproxy \
  --env AIXPROXY_API_KEY=sk_test_xxx \
  -- npx -y @aixproxy/mcp

3Or add it to any MCP-capable client

For the Claude Agent SDK, Claude Desktop, or any other MCP client, add this entry to your MCP configuration file and restart the client.

mcp config (JSON)

{
  "mcpServers": {
    "aixproxy": {
      "command": "npx",
      "args": ["-y", "@aixproxy/mcp"],
      "env": {
        "AIXPROXY_API_KEY": "sk_test_xxx"
      }
    }
  }
}

4Make your first request

Ask your agent to fetch a page through AixIps. The platform routes the request based on the declared intent and returns a structured result.

first request

# Ask your agent (e.g. in Claude Code):
"Use the aixproxy fetch_url tool to get
 https://httpbin.org/ip via a jp residential exit."

# The tool call your agent makes:
fetch_url(
  url="https://httpbin.org/ip",
  country="jp",
  intent="explore"
)

5Verify

A successful call returns status 200 with exit metadata. The origin IP belongs to the requested region — not your machine. You can also confirm the request in the console under Usage.

expected result

{
  "status": 200,
  "exit": { "country": "jp", "type": "residential" },
  "body": { "origin": "203.0.113.42" }
}

Tip: pass persona="p_your_persona_id" to fetch_url to reuse a persistent identity across tasks — see the Personas concept guide.

Next steps

Personas

Persistent identities your agent can reuse.

API reference

All MCP tools and gateway parameters.