@dominusnode/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dominus Node
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,303 @@
+# @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
+
+```bash
+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):
+
+```json
+{
+  "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:
+
+```json
+{
+  "mcpServers": {
+    "dominusnode": {
+      "command": "npx",
+      "args": ["-y", "@dominusnode/mcp-server"],
+      "env": {
+        "DOMINUSNODE_API_KEY": "dn_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Gemini CLI
+
+```json
+{
+  "mcpServers": {
+    "dominusnode": {
+      "command": "npx",
+      "args": ["-y", "@dominusnode/mcp-server"],
+      "env": {
+        "DOMINUSNODE_API_KEY": "dn_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Codex CLI
+
+```json
+{
+  "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:
+
+```json
+{
+  "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`:
+
+```json
+{
+  "mcpServers": {
+    "dominusnode": {
+      "command": "npx",
+      "args": ["-y", "@dominusnode/mcp-server"],
+      "env": {
+        "DOMINUSNODE_API_KEY": "dn_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### LangChain / LangGraph
+
+```python
+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:
+
+```json
+{
+  "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](docs/eliza-integration.md)
+- [LangChain Integration](docs/langchain-integration.md)
+
+## Development
+
+```bash
+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

package/dist/src/config.d.ts

@@ -0,0 +1,15 @@
+export interface McpConfig {
+    apiKey: string | null;
+    apiUrl: string;
+    proxyHost: string;
+    httpProxyPort: number;
+    socks5ProxyPort: number;
+    fetchTimeoutMs: number;
+    fetchMaxResponseBytes: number;
+    mcpAgentSecret: string;
+}
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+export declare function parseConfig(env?: Record<string, string | undefined>): McpConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,SAAS,CAsG5F"}

package/dist/src/config.js

@@ -0,0 +1,111 @@
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+export function parseConfig(env = process.env) {
+    const apiKey = env["DOMINUSNODE_API_KEY"] ?? null;
+    // Validate format if provided, but allow null for bootstrap mode
+    if (apiKey !== null && !apiKey.startsWith("dn_live_")) {
+        throw new ConfigError("DOMINUSNODE_API_KEY must start with 'dn_live_'");
+    }
+    const apiUrl = (env["DOMINUSNODE_API_URL"] ?? "https://api.dominusnode.com").replace(/\/+$/, "");
+    // Validate API URL protocol to prevent credential leakage to non-HTTPS endpoints
+    try {
+        const parsedApiUrl = new URL(apiUrl);
+        if (parsedApiUrl.protocol !== "https:" && parsedApiUrl.protocol !== "http:") {
+            throw new ConfigError("DOMINUSNODE_API_URL must use http: or https: protocol");
+        }
+        // Warn when http: is used for non-localhost (credentials sent in plaintext)
+        if (parsedApiUrl.protocol === "http:" && !["localhost", "127.0.0.1", "[::1]"].includes(parsedApiUrl.hostname)) {
+            process.stderr.write("WARNING: DOMINUSNODE_API_URL uses http: — credentials will be sent in plaintext. Use https: in production.\n");
+        }
+    }
+    catch (e) {
+        if (e instanceof ConfigError)
+            throw e;
+        throw new ConfigError("DOMINUSNODE_API_URL is not a valid URL");
+    }
+    const proxyHost = env["DOMINUSNODE_PROXY_HOST"] ?? "proxy.dominusnode.com";
+    // Validate proxyHost strictly to prevent SSRF via config injection
+    if (!/^[a-zA-Z0-9.\-]+$/.test(proxyHost)) {
+        throw new ConfigError("DOMINUSNODE_PROXY_HOST contains invalid characters (only alphanumeric, dots, hyphens allowed)");
+    }
+    if (proxyHost.length > 253) {
+        throw new ConfigError("DOMINUSNODE_PROXY_HOST exceeds maximum hostname length (253)");
+    }
+    // Block bare localhost and other loopback/private hostnames
+    const BLOCKED_PROXY_HOSTS = new Set([
+        "localhost", "localhost.localdomain", "ip6-localhost", "ip6-loopback",
+        "0.0.0.0", "127.0.0.1",
+    ]);
+    const proxyHostLower = proxyHost.toLowerCase();
+    if (BLOCKED_PROXY_HOSTS.has(proxyHostLower) ||
+        proxyHostLower.endsWith(".internal") ||
+        proxyHostLower.endsWith(".local") ||
+        proxyHostLower.endsWith(".localhost")) {
+        throw new ConfigError("DOMINUSNODE_PROXY_HOST must not be a localhost/internal hostname");
+    }
+    // Block private IP ranges
+    const ipMatch = proxyHost.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
+    if (ipMatch) {
+        // Block octal notation IPs (e.g., 0177.0.0.1) to prevent private IP bypass
+        const octets = [ipMatch[1], ipMatch[2], ipMatch[3], ipMatch[4]];
+        if (octets.some(o => o.startsWith("0") && o.length > 1)) {
+            throw new ConfigError("DOMINUSNODE_PROXY_HOST must not use octal IP notation");
+        }
+        const a = parseInt(ipMatch[1], 10);
+        const b = parseInt(ipMatch[2], 10);
+        if (a === 127 || a === 10 || a === 0 || (a === 172 && b >= 16 && b <= 31) || (a === 192 && b === 168)) {
+            throw new ConfigError("DOMINUSNODE_PROXY_HOST must not be a private/loopback IP address");
+        }
+    }
+    const httpProxyPort = parsePort(env["DOMINUSNODE_HTTP_PROXY_PORT"], 8080, "DOMINUSNODE_HTTP_PROXY_PORT");
+    const socks5ProxyPort = parsePort(env["DOMINUSNODE_SOCKS5_PROXY_PORT"], 1080, "DOMINUSNODE_SOCKS5_PROXY_PORT");
+    const fetchTimeoutMs = parsePositiveInt(env["DOMINUSNODE_FETCH_TIMEOUT_MS"], 30_000, "DOMINUSNODE_FETCH_TIMEOUT_MS");
+    if (fetchTimeoutMs > 120_000) {
+        throw new ConfigError("DOMINUSNODE_FETCH_TIMEOUT_MS must not exceed 120000");
+    }
+    const fetchMaxResponseBytes = parsePositiveInt(env["DOMINUSNODE_FETCH_MAX_RESPONSE_BYTES"], 5 * 1024 * 1024, "DOMINUSNODE_FETCH_MAX_RESPONSE_BYTES");
+    // Enforce upper bound to prevent config-based OOM
+    const MAX_FETCH_RESPONSE_BYTES = 50 * 1024 * 1024; // 50MB hard cap
+    if (fetchMaxResponseBytes > MAX_FETCH_RESPONSE_BYTES) {
+        throw new ConfigError(`DOMINUSNODE_FETCH_MAX_RESPONSE_BYTES must not exceed ${MAX_FETCH_RESPONSE_BYTES}`);
+    }
+    // Shared secret for MCP agent auto-verification (prevents header spoofing)
+    const mcpAgentSecret = env["MCP_AGENT_SECRET"] ?? "";
+    // Enforce minimum strength when MCP_AGENT_SECRET is set
+    if (mcpAgentSecret && mcpAgentSecret.length < 32) {
+        throw new ConfigError("MCP_AGENT_SECRET must be at least 32 characters when set");
+    }
+    return {
+        apiKey,
+        apiUrl,
+        proxyHost,
+        httpProxyPort,
+        socks5ProxyPort,
+        fetchTimeoutMs,
+        fetchMaxResponseBytes,
+        mcpAgentSecret,
+    };
+}
+function parsePort(value, defaultValue, name) {
+    if (value === undefined)
+        return defaultValue;
+    const n = parseInt(value, 10);
+    if (isNaN(n) || n < 1 || n > 65535) {
+        throw new ConfigError(`${name} must be a valid port number (1-65535)`);
+    }
+    return n;
+}
+function parsePositiveInt(value, defaultValue, name) {
+    if (value === undefined)
+        return defaultValue;
+    const n = parseInt(value, 10);
+    if (isNaN(n) || n <= 0) {
+        throw new ConfigError(`${name} must be a positive integer`);
+    }
+    return n;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}

package/dist/src/http-client.d.ts

@@ -0,0 +1,23 @@
+import type { TokenManager } from "./token-manager.js";
+export interface HttpRequestOptions {
+    method: string;
+    path: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+    requiresAuth?: boolean;
+}
+export declare class HttpClient {
+    private baseUrl;
+    private tokenManager;
+    private rateLimiter;
+    private mcpAgentSecret;
+    constructor(baseUrl: string, tokenManager: TokenManager, mcpAgentSecret?: string);
+    request<T>(opts: HttpRequestOptions): Promise<T>;
+    /** Store tokens from an external auth flow (e.g., registration in bootstrap mode) */
+    storeTokens(accessToken: string, refreshToken: string): void;
+    get<T>(path: string, requiresAuth?: boolean): Promise<T>;
+    post<T>(path: string, body?: unknown, requiresAuth?: boolean): Promise<T>;
+    patch<T>(path: string, body?: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/src/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAwFvD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,UAAU;IAKnB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,YAAY;IALtB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAS;gBAGrB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAClC,cAAc,SAAK;IASf,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IA+ItD,qFAAqF;IACrF,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAItD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,UAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAItE,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAG1C"}