# TrueProxies

Wires your TrueProxies account into an MCP client so the assistant can read plans, services, traffic and invoices.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: trueproxies-com
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trueproxies-com/trueproxies-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/trueproxies

## What it does

This server exposes your TrueProxies account to the assistant: available plans with prices, your services, traffic spent and left, current download and upload speed, usage history across 24h, 7d or 30d windows, and invoices. It also builds proxy connection lines and can test a connection with a single request.

Every tool is read-only except `check_connection`. Buying, paying, rotating your proxy password or editing trusted IPs is out of scope. The connection check burns a bit of traffic and activates an unused free trial, so think twice if you were saving that trial.

You create the API key in the TrueProxies dashboard. Read-only use needs `services:read` and `billing:read`. Add `proxy:read` only when the assistant should generate endpoints, run connection checks or list trusted IPs, because endpoint lines carry your proxy password. The hosted endpoint sits behind Cloudflare, which decrypts traffic in transit, so your key and any endpoints pass through it. Run the server locally with Docker or Go if that matters to you.

## Requirements
- Needs: Docker
- Remote server: `https://mcp.trueproxies.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.trueproxies.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add trueproxies --url https://mcp.trueproxies.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "trueproxies": {
            "url": "https://mcp.trueproxies.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "trueproxies": {
            "type": "http",
            "url": "https://mcp.trueproxies.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http trueproxies https://mcp.trueproxies.com/mcp
```

## When to use it
- check remaining traffic on a service
- compare plans and prices before buying
- pull a list of invoices
- verify that a proxy actually responds
- build a connection line with username and password

## Example prompts
- List my TrueProxies services and the traffic left on each
- Generate endpoints for my service and run a connection check
- What plans and prices does TrueProxies offer?

## Similar
- [omni-version-manager](https://affpapa.org/en/nevibecode/skills/omni-version-manager.md) — skill · 975 installs
- [freellmapi-proxy](https://affpapa.org/en/nevibecode/skills/freellmapi-proxy.md) — skill · 351 installs
- [omni-settings](https://affpapa.org/en/nevibecode/skills/omni-settings.md) — skill · 1000 installs
- [2extract](https://affpapa.org/en/nevibecode/mcp/2extract.md) — MCP server · ★ 1
- [masterhttprelayvpn-proxy](https://affpapa.org/en/nevibecode/skills/masterhttprelayvpn-proxy.md) — skill · 365 installs
- [kernel-python-sdk](https://affpapa.org/en/nevibecode/skills/kernel-python-sdk.md) — skill · 357 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md