Docs/Quickstart/MCP

MCP — Claude Code & Agent SDK

Connect your agent to Aixips in five minutes with one MCP server entry. Your client discovers the available tools and their parameter schemas directly from the connected server.

1Prerequisites

You need a client that supports Streamable HTTP and an Aixips API key. Create a key in the console — the snippets below use the placeholder YOUR_API_KEY.

2Connect to the hosted MCP server

With Claude Code, one command connects to the hosted MCP endpoint at https://aixips.com/mcp. Authentication uses your API key in the Authorization header.

Claude Code

claude mcp add --transport http aixproxy https://aixips.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

3Or add it to any MCP-capable client

For any MCP client that supports Streamable HTTP and custom headers, add this entry to your MCP configuration file and restart the client.

mcp config (JSON)

{
  "mcpServers": {
    "aixproxy": {
      "type": "http",
      "url": "https://aixips.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

4Discover available capabilities

Ask your agent to describe the connected AixIps capabilities. The client obtains tool descriptions and input schemas through MCP. The MCP tools/list response is the source of truth for available interfaces and their accepted parameters.

5Make a first request

Ask your agent for a proxy in your preferred country. It selects the appropriate tool using the discovered schema. Use the returned endpoint and credentials in your proxy client; traffic appears under Usage after the client connects.

Tip: use a Persona handle in your proxy username to reuse a persistent identity across tasks — see the Personas guide.

Next steps

Personas

Persistent identities your agent can reuse.

API reference

MCP discovery and gateway parameters.