@dominusnode/mcp-server

MCP (Model Context Protocol) server for Dominus Node — rotating proxy tools for AI agents.

One server, every AI platform: Claude Desktop, Claude Code, Gemini CLI, Codex CLI, Cursor, VS Code, Jan AI, Docker AI, elizaOS, LangChain, and any MCP-compatible client.

Features

• 24 tools for proxy access, account management, billing, crypto payments, and usage monitoring
• dominusnode_fetch — fetch any URL through rotating residential/datacenter proxies
• Geo-targeting — route requests through specific countries, states, or cities
• Bootstrap mode — start with no API key, let the agent create its own account
• Crypto payments — pay with BTC, ETH, LTC, XMR, ZEC, USDC, SOL, USDT, DAI, BNB, LINK — or card/PayPal via Stripe
• x402 ready — machine-to-machine USDC micropayments (Coinbase Agentic Wallets)
• Free tier — 1GB bandwidth, 10 connections, no payment required

Quick Install

npx @dominusnode/mcp-server

No API key? No problem — the server starts in bootstrap mode with tools to create an account and start using proxies immediately.

Setup by Platform

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "dominusnode": {
      "command": "npx",
      "args": ["-y", "@dominusnode/mcp-server"],
      "env": {
        "DOMINUSNODE_API_KEY": "dn_live_your_key_here"
      }
    }
  }
}

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "dominusnode": {
      "command": "npx",
      "args": ["-y", "@dominusnode/mcp-server"],
      "env": {
        "DOMINUSNODE_API_KEY": "dn_live_your_key_here"
      }
    }
  }
}

Gemini CLI

{
  "mcpServers": {
    "dominusnode": {
      "command": "npx",
      "args": ["-y", "@dominusnode/mcp-server"],
      "env": {
        "DOMINUSNODE_API_KEY": "dn_live_your_key_here"
      }
    }
  }
}

Codex CLI

{
  "mcpServers": {
    "dominusnode": {
      "command": "npx",
      "args": ["-y", "@dominusnode/mcp-server"],
      "env": {
        "DOMINUSNODE_API_KEY": "dn_live_your_key_here"
      }
    }
  }
}

Cursor / VS Code

Add to MCP server settings:

{
  "dominusnode": {
    "command": "npx",
    "args": ["-y", "@dominusnode/mcp-server"],
    "env": {
      "DOMINUSNODE_API_KEY": "dn_live_your_key_here"
    }
  }
}

elizaOS

Add to your agent's character.json:

{
  "mcpServers": {
    "dominusnode": {
      "command": "npx",
      "args": ["-y", "@dominusnode/mcp-server"],
      "env": {
        "DOMINUSNODE_API_KEY": "dn_live_your_key_here"
      }
    }
  }
}

LangChain / LangGraph

from langchain_mcp_adapters.client import MultiServerMCPClient

async with MultiServerMCPClient({
    "dominusnode": {
        "command": "npx",
        "args": ["-y", "@dominusnode/mcp-server"],
        "env": {"DOMINUSNODE_API_KEY": "dn_live_your_key_here"}
    }
}) as client:
    tools = client.get_tools()

Jan AI / Docker AI

Same MCP config pattern — any client that speaks MCP over stdio works.

Bootstrap Mode (No API Key)

Start without any configuration — the agent creates its own account:

{
  "mcpServers": {
    "dominusnode": {
      "command": "npx",
      "args": ["-y", "@dominusnode/mcp-server"]
    }
  }
}

Available bootstrap tools:

• dominusnode_setup — one-shot account creation
• dominusnode_register / dominusnode_login — step-by-step
• dominusnode_pay_crypto — fund with crypto
• dominusnode_x402_info — machine-to-machine payment info
• dominusnode_agent_wallet_create / dominusnode_agent_wallet_balance — Coinbase Agentic Wallet

Tools Reference (24 total)

Proxy

| Tool | Description | |------|-------------| | dominusnode_fetch | Fetch URL through rotating proxy (HTTP/HTTPS, geo-targeting) | | dominusnode_get_proxy_config | Proxy endpoints and geo options | | dominusnode_get_proxy_status | Live status, latency, providers |

Account (Self-Service)

| Tool | Description | |------|-------------| | dominusnode_register | Create a new account (free tier, no payment needed) | | dominusnode_login | Login with email/password | | dominusnode_setup | One-shot: register + create API key + get proxy config | | dominusnode_get_account_info | Account email, status, MFA |

Billing

| Tool | Description | |------|-------------| | dominusnode_get_balance | Wallet balance in USD | | dominusnode_get_forecast | Spending forecast, days remaining | | dominusnode_get_transactions | Transaction history (paginated) |

Crypto Payments

| Tool | Description | |------|-------------| | dominusnode_pay_crypto | Create crypto invoice (BTC/ETH/LTC/XMR/ZEC/USDC/SOL/USDT/DAI/BNB/LINK) | | dominusnode_check_payment | Check crypto payment status |

x402 & Agentic Wallets

| Tool | Description | |------|-------------| | dominusnode_x402_info | Get x402 micropayment protocol info | | dominusnode_agent_wallet_create | Create Coinbase Agentic Wallet with spending limits | | dominusnode_agent_wallet_balance | Check agentic wallet balance and budget |

Usage

| Tool | Description | |------|-------------| | dominusnode_get_usage | Usage summary (bytes, cost, requests) | | dominusnode_get_daily_usage | Daily bandwidth breakdown | | dominusnode_get_top_hosts | Top target hosts by bandwidth |

API Keys

| Tool | Description | |------|-------------| | dominusnode_list_keys | List API keys | | dominusnode_create_key | Create new API key (shown once) | | dominusnode_revoke_key | Revoke API key by ID |

Plans & Sessions

| Tool | Description | |------|-------------| | dominusnode_get_plan | Current plan and monthly usage | | dominusnode_list_plans | Available pricing plans | | dominusnode_get_active_sessions | Active proxy sessions |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | DOMINUSNODE_API_KEY | No | — | API key (omit for bootstrap mode) | | DOMINUSNODE_API_URL | No | https://api.dominusnode.com | REST API base URL | | DOMINUSNODE_PROXY_HOST | No | proxy.dominusnode.com | Proxy gateway host | | DOMINUSNODE_HTTP_PROXY_PORT | No | 8080 | HTTP proxy port | | DOMINUSNODE_SOCKS5_PROXY_PORT | No | 1080 | SOCKS5 proxy port | | DOMINUSNODE_FETCH_TIMEOUT_MS | No | 30000 | Proxy fetch timeout (max 120000) | | DOMINUSNODE_FETCH_MAX_RESPONSE_BYTES | No | 5242880 | Max response body (5MB) |

Pricing

| Tier | Price | Bandwidth | |------|-------|-----------| | Free | $0 | 1 GB/month, 10 connections | | Pay-as-you-go | $5/GB | Unlimited | | Volume 100GB | $4/GB | 100 GB/month | | Volume 1TB | $3/GB | 1 TB/month |

Crypto payments: BTC, ETH, LTC, XMR, ZEC, USDC, SOL, USDT, DAI, BNB, LINK

Example: AI Agent Workflow

Agent: "I need to scrape product prices from 3 countries"

1. dominusnode_setup(email, password) → account + API key (if bootstrap mode)
2. dominusnode_get_balance() → "$0.00 (free tier: 1GB available)"
3. dominusnode_fetch(url: "https://shop.example.com/prices", country: "US") → US prices
4. dominusnode_fetch(url: "https://shop.example.com/prices", country: "GB") → UK prices
5. dominusnode_fetch(url: "https://shop.example.com/prices", country: "DE") → DE prices
6. dominusnode_get_usage(days: 1) → "0.3 MB, $0.002"

Agent: "I need anonymous proxy access"

1. dominusnode_pay_crypto(amount_usd: 10, currency: "XMR") → Monero invoice
2. (agent pays invoice)
3. dominusnode_check_payment(invoice_id) → "confirmed, $10.00 credited"
4. dominusnode_fetch(url: "https://target.com", country: "JP") → response

Integration Guides

• elizaOS Integration
• LangChain Integration

Development

cd packages/mcp-server
npm install
npm run build
npm test

# Run locally
DOMINUSNODE_API_KEY=dn_live_xxx node dist/src/index.js

# Run in bootstrap mode (no key)
node dist/src/index.js

License

MIT