All systems operationalโ€ขIP pool status
Coronium Mobile Proxies
๐Ÿš€ Beta v0.3.0
๐Ÿ”“ Open Source
๐Ÿ“ฆ MIT License

Works with MCP-Compatible AI Tools

Coronium Mobile Proxy MCP Server

Enable Claude, Cursor, Windsurf, and other AI assistants to authenticate and manage your Coronium mobile proxies through the Model Context Protocol. Open-source, secure, and production-ready.

Works with Claude, Cursor, Windsurf & other MCP-compatible AI tools
Secure token storage with AES-256-CBC encryption
Persistent sessions - authenticate once, use everywhere
Open source - audit, modify, and contribute
v0.3.0
Latest Version
4
MCP Tools
MIT
License
coronium@mcp-server:~
bash
coronium@mcp:~$git clone https://github.com/coroniumio/coronium-proxy-mcp.git
Cloning into 'coronium-proxy-mcp'...
remote: Enumerating objects: 147, done.
remote: Total 147 (delta 0), reused 0 (delta 0), pack-reused 147
Receiving objects: 100% (147/147), 42.31 KiB | 2.11 MiB/s, done.
coronium@mcp:~$cd coronium-proxy-mcp && npm install
โœ“ Dependencies installed (2.3s)
coronium@mcp:~/coronium-proxy-mcp$npm run build
โœ“ Build completed successfully
dist/server.js 42.3kb
dist/index.js 18.7kb
coronium@mcp:~/coronium-proxy-mcp$npm start
[INFO] Starting Coronium MCP Server v0.3.0
[INFO] Loading environment configuration...
[SUCCESS] Server initialized on stdio
[SUCCESS] 4 tools registered:
โ€ข coronium_get_token
โ€ข coronium_check_token
โ€ข coronium_get_proxies
โ€ข coronium_get_crypto_balance
[INFO] Ready for connections from Claude, Cursor, Windsurf...
coronium@mcp:~/coronium-proxy-mcp$
โšก 3-Step Setup

Quick Start Installation

Install, configure, and start managing proxies in under 5 minutes

1

Install

Clone and build the server

$ git clone https://github.com/coroniumio/coronium-proxy-mcp.git
$ cd coronium-proxy-mcp
$ npm install
$ npm run build
Prerequisites:
2

Configure

Add to your AI tool

Claude Desktop Config:

{
  "mcpServers": {
    "coronium": {
      "command": "node",
      "args": ["/path/to/coronium-proxy-mcp/dist/server.js"],
      "env": {
        "CORONIUM_LOGIN": "your@email.com",
        "CORONIUM_PASSWORD": "your-password"
      }
    }
  }
}

โš ๏ธ MCP Compatibility:โœ… Claude Desktop - Fully supported
โณ Cline - In development
โŒ Cursor, Continue - Not MCP-compatible yet

3

Use

Start managing proxies

Example Commands:

๐Ÿ’ฌ "Show my Coronium proxies"
๐Ÿ’ฌ "Check my crypto balance"
๐Ÿ’ฌ "List my saved cards"
๐Ÿ’ฌ "Get proxy connection strings"

Auto-Authentication: The AI will authenticate automatically on first use using your configured credentials.

Configuration File Locations

Claude Desktop:
๐ŸŽ macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
๐ŸชŸ Windows: %APPDATA%\Claude\claude_desktop_config.json
Other MCP Tools:
Check your tool's documentation for MCP server configuration. Only tools with explicit MCP support will work.

Available Commands

coronium_get_tokenAuthenticate (auto-runs)
coronium_get_proxiesList all proxies
coronium_get_crypto_balanceBTC/USDT balances
coronium_get_credit_cardsSaved payment methods
coronium_check_tokenVerify auth status

Environment Variables

# Required
CORONIUM_LOGIN=your@email.com
CORONIUM_PASSWORD=your-password

# Optional
TOKEN_ENCRYPTION_KEY=your-32-byte-hex
LOG_LEVEL=info  # debug, info, warn, error

Generate key: openssl rand -hex 32

Key Features

Built with security and simplicity in mind, our MCP server provides everything you need to integrate Coronium proxies with Claude Desktop.

Secure Authentication

Token-based auth with AES-256-CBC encryption for maximum security

Persistent Sessions

Encrypted token storage between Claude sessions for seamless experience

Environment Config

Keep credentials secure in .env files, never exposed in code

Simple Integration

Two-step setup with Claude Desktop - install and configure

Available MCP Tools

Four powerful tools to manage your Coronium proxies directly from Claude

coronium_get_token

Authenticate and obtain access token

Parameters: login (optional), password (optional)

coronium_check_token

Verify if stored token is valid

Parameters: token (optional)

coronium_get_proxies

List all mobile proxies with connection details

Parameters: token (optional)

coronium_get_crypto_balance

Get cryptocurrency balance and payment addresses

Parameters: token (optional)

AI IDE Configuration

Configure your AI IDE (Claude, Cursor, Windsurf) to use the MCP server with your Coronium account

Edit claude_desktop_config.json

Config File Locations

  • macOS: ~/Library/Application Support/Claude/
  • Windows: %APPDATA%\Claude\
  • Linux: ~/.config/Claude/
json
{
  "mcpServers": {
    "coronium": {
      "command": "node",
      "args": ["/path/to/coronium-proxy-mcp/dist/server.js"],
      "env": {
        "CORONIUM_LOGIN": "your@email.com",
        "CORONIUM_PASSWORD": "your-password",
        "TOKEN_ENCRYPTION_KEY": "your-secure-key",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Important: Use absolute paths and restart Claude Desktop completely after saving the config.

Usage Examples

See how easy it is to manage your proxies through Claude

Authentication Flow

You: Please authenticate with my Coronium account
Claude: I'll authenticate with your Coronium account now.
[Uses coronium_get_token]
โœ… Authentication successful! Token stored securely.

List Proxies

You: Show me my proxies
Claude: I'll fetch your mobile proxies now.
[Uses coronium_get_proxies]
๐Ÿ”Œ Found 4 Proxy Connection(s)
โ€ข US Proxy - socks5://user:pass@ip:port
โ€ข UK Proxy - socks5://user:pass@ip:port

Ready to Integrate Claude with Coronium?

Join the community of developers using MCP to automate their proxy management. Open source, secure, and constantly improving.

MIT License
TypeScript
Active Development