Skip to main content

Connect Anthropic Messages API to aicharged.io

215 tools, one endpoint: https://aicharged.io/api/v1/mcp

Anthropic Messages API

Anthropic Messages API MCP connector (beta): mcp_servers plus an mcp_toolset — Claude calls aicharged.io straight from the API.

  • API key (Bearer)

Hosted MCP tool — the API calls aicharged.io for you

Recommended 
import os
import anthropic

client = anthropic.Anthropic()
response = client.beta.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    betas=["mcp-client-2025-11-20"],
    messages=[{"role": "user", "content": "List my recent aicharged.io runs"}],
    mcp_servers=[{
        "type": "url",
        "url": "https://aicharged.io/api/v1/mcp",
        "name": "aicharged",
        "authorization_token": os.environ["AICHARGED_API_KEY"],
    }],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "aicharged"}],
)
print(response.content)

Beta feature: keep the mcp-client-2025-11-20 beta flag. The API sends authorization_token to aicharged.io as the Bearer token.

The same request with curl

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 16000,
    "messages": [{"role": "user", "content": "List my recent aicharged.io runs"}],
    "mcp_servers": [{"type": "url", "url": "https://aicharged.io/api/v1/mcp", "name": "aicharged", "authorization_token": "<API_KEY>"}],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "aicharged"}]
  }'

Or let the CLI set it up

aicharged setup finds the AI clients on this machine, signs you in through the browser and writes their configuration.

Connect in one line

Install the CLI · macOS / Linux
curl -fsSL https://aicharged.io/install.sh | sh && aicharged setup
Install the CLI · Windows
irm https://aicharged.io/install.ps1 | iex; aicharged setup
MCP endpoint
https://aicharged.io/api/v1/mcp

Streamable HTTP. Send the header Authorization: Bearer <API_KEY>, or sign in with OAuth where your client supports it.

Or tell your agent
Read https://aicharged.io/agent.md and set me up with aicharged.io

Open with this prompt in Claude (opens in a new tab) ChatGPT (opens in a new tab) Perplexity (opens in a new tab)