Beta v0.3.0

Open Source

MIT License

Works with MCP-Compatible AI Tools

Coronium Mobile Proxy Management MCP Server

Powerful Mobile Proxy Authentication & Fetching for Claude

Enable Claude Code, Cursor IDE, and ALL MCP-compatible AI tools to authenticate and manage your Coronium mobile proxies. Beta version, more functionality coming soon.

Compatible with ALL MCP-enabled AI tools (Claude Code, Cursor IDE, Windsurf, etc.)

AES-256-CBC encryption with secure local token storage

Cryptocurrency payment workflow with BTC/USDT support

Advanced troubleshooting & comprehensive security features

v0.3.0

Latest Version

MCP Tools

ALL

MCP Compatible

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 Code, Cursor IDE, Windsurf...

coronium@mcp:~/coronium-proxy-mcp$

5-Step Installation

Quick Installation Guide

Single-column vertical flow for easy step-by-step installation

📋

Prerequisites

Required tools and accounts

Node.js 18+

Runtime required

npm

Package manager

Coronium Account

API credentials

Claude Code

Or any MCP client

Clone & Install

Download and build the MCP server

# Clone the repository
git clone https://github.com/coroniumio/coronium-proxy-mcp.git
cd coronium-proxy-mcp

# Install dependencies
npm install

# Build the server
npm run build

Configure Credentials

Set up .env file with your Coronium credentials

# Create .env file in project root
CORONIUM_LOGIN=your@email.com
CORONIUM_PASSWORD=your-password

# Optional (generates automatically if not provided)
TOKEN_ENCRYPTION_KEY=your-32-byte-hex-key
LOG_LEVEL=info

Security Tip: Generate encryption key with: openssl rand -hex 32

Test the Server

Verify the MCP server starts correctly

$ npm start

[INFO] Starting Coronium MCP Server v0.3.0
[SUCCESS] Server initialized on stdio
[SUCCESS] 4 tools registered

Success: If you see "4 tools registered", the server is working correctly!

Configure Your AI Tool

Setup MCP server in your chosen tool

Option A: Claude Code (Recommended)

Create .mcp.json in your project folder:

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

Option B: Cursor IDE

Create .cursor/mcp.json in your project root:

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

Option C: Windsurf, Cline, VSCode, etc.

Add the same configuration to your tool's MCP settings. Check your tool's documentation for the exact location.

Important: Use absolute paths and restart your AI tool after saving!

Verify Integration

Test the connection

Test Commands to Try:

"Please authenticate with my Coronium account"

"Show me my mobile proxies"

"Check my cryptocurrency balance"

"List my proxy connection details"

Success: If your AI responds with proxy information, you're all set!

Integration Guide

Complete Integration Documentation

Choose your preferred AI tool below. All configurations follow the same pattern with tool-specific file locations.

Primary AI IDEs

Claude Code (Recommended)

Native MCP support with project-level config

.mcp.json (project folder)

Cursor IDE

Full MCP integration with advanced features

.cursor/mcp.json (project root)

Windsurf

Native MCP support

Check Windsurf settings

CLI & Extensions

Claude Code (CLI)

Project-level configuration

.mcp.json (project folder)

Cline (VS Code)

Configure via extension UI

MCP Servers icon → Configure

VS Code + Copilot

v1.102+ with MCP support

.vscode/mcp.json or settings

Universal Configuration Template

Same JSON structure works for all MCP-compatible tools

{
  "mcpServers": {
    "coronium": {
      "command": "node",
      "args": ["/absolute/path/to/coronium-proxy-mcp/dist/server.js"],
      "env": {
        "CORONIUM_LOGIN": "your-email@example.com",
        "CORONIUM_PASSWORD": "your-password",
        // Optional: Custom encryption key
        "TOKEN_ENCRYPTION_KEY": "your-32-byte-hex-key",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Copy Template

Add Credentials

Restart Tool

Quick Reference: Configuration File Locations

Tool	Platform	Configuration Path
Claude Desktop	macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop	Windows	%APPDATA%\Claude\claude_desktop_config.json
Claude Code	All	.mcp.json (in project folder)
Cursor IDE	All	.cursor/mcp.json (in project root)
Cline	VS Code	Configure via extension UI
VS Code	All	.vscode/mcp.json or settings.json

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 any MCP-compatible AI IDE.

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 any AI IDE - 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)

Usage Examples

Real conversation flows showing how to interact with the MCP server

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 with AES-256-CBC encryption.

Proxy Management

You: Show me my mobile proxies with connection details

Claude: I'll fetch your mobile proxies now.

[Uses coronium_get_proxies]

🔌 Found 4 Proxy Connection(s)

• US Proxy (Los Angeles) - socks5://user:pass@ip:port

• UK Proxy (London) - socks5://user:pass@ip:port

Crypto Balance Check

You: Check my cryptocurrency balance

Claude: I'll check your crypto balance and wallet addresses.

[Uses coronium_get_crypto_balance]

💰 BTC Balance: 0.001245 BTC

• USDT Balance: 25.50 USDT

• BTC Wallet: bc1q...abc123

Token Verification

You: Is my authentication still valid?

Claude: I'll check your stored authentication token.

[Uses coronium_check_token]

✓ Token is valid (expires in 2 hours)

• Encrypted storage location: Local secure store

Cryptocurrency Payment Workflow

Seamless BTC and USDT payment integration for proxy services

Check Balance

View your BTC and USDT wallet balances instantly through Claude

Get Wallet Address

Retrieve payment addresses for topping up your proxy account

Auto-Detection

Automatic balance updates and transaction monitoring

Security Features

Enterprise-grade security with local storage and advanced encryption

AES-256-CBC Encryption

Military-grade encryption for all stored tokens and sensitive data

Local Storage

All credentials stored locally - never sent to external servers

Environment Variables

Secure credential management through .env files

Auto-Generated Keys

Automatic encryption key generation if not provided

Token Rotation

Automatic token refresh and expiration handling

Audit Logs

Comprehensive logging for security monitoring and debugging

Troubleshooting Guide

Common issues and solutions for smooth operation

Server Won't Start

Issue: "Error: Cannot find module" or build failures

Solutions:

• Run npm install again
• Delete node_modules and run npm ci
• Ensure Node.js 18+ is installed
• Check file permissions on the project directory

Authentication Failures

Issue: "Invalid credentials" or "Token expired"

Solutions:

• Verify .env file has correct email/password
• Check Coronium account status at coronium.io
• Clear stored tokens: delete ~/.coronium-mcp/
• Try manual authentication first

Claude Desktop Integration

Issue: Claude doesn't recognize the MCP server

Solutions:

• Use absolute paths in claude_desktop_config.json
• Restart Claude Desktop completely
• Check config file syntax with a JSON validator
• Ensure server builds successfully first

Connection Issues

Issue: "Network error" or "Timeout" messages

Solutions:

• Check internet connection
• Verify firewall isn't blocking the server
• Test API directly: curl https://api.coronium.io
• Enable debug logging: LOG_LEVEL=debug

Ready to Integrate ALL MCP Tools with Coronium?

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

v0.3.0 Released

Crypto Payments

Enterprise Security