MCPTotal CLI

CLI for MCPTotal - MCP proxy with tunnel support.

Installation

npm install -g @mcp-total/mcpt

Usage

MCP Proxy Mode

Run as stdio MCP proxy (for Claude Desktop, Cursor, etc.):

mcpt --mcp https://mcp.mcptotal.io/mcp-xxx

Claude Desktop config:

{
  "mcpServers": {
    "mcptotal": {
      "command": "npx",
      "args": ["@mcp-total/mcpt", "--mcp", "https://mcp.mcptotal.io/mcp-xxx"]
    }
  }
}

Tunnel Mode

Run tunnel client for private network access:

# With OAuth (opens browser for authentication)
mcpt --tunnel https://mcp.mcptotal.io/mcp-xxx

# With API key
mcpt --tunnel "https://mcp.mcptotal.io/mcp-xxx?key=your-api-key"

MCP + Tunnel

Run both MCP proxy and tunnel together:

mcpt --mcp --tunnel https://mcp.mcptotal.io/mcp-xxx

OAuth Login Only

Authenticate without running proxy or tunnel:

mcpt https://mcp.mcptotal.io/mcp-xxx

Options

| Option | Description | |--------|-------------| | <url> | MCPTotal space URL (required) | | -m, --mcp | Run MCP proxy mode (stdio proxy to remote MCP server) | | -t, --tunnel | Run tunnel mode (TCP/UDP tunnel client) | | -k, --key <key> | API key (overrides URL parameter) | | --retry-delay <ms> | Initial retry delay in ms for tunnel (default: 1000) | | -v, --verbose | Enable verbose logging |

Authentication

Authentication can be provided via:

• API key in URL: ?key=xxx
• CLI option: --key xxx
• OAuth: Auto-reads tokens from ~/.mcptotal/mcp-oauth/

When using OAuth, the CLI will open your browser for authentication on first use.

Tunnel Limitations

MCP traffic is transparently routed through the connector. Remote services observe the connector’s IP (not the MCP container’s internal IP), which may affect path-sensitive UDP protocols such as QUIC or WebRTC P2P.

License

MIT