@tokium-labs/mcp

MCP (Model Context Protocol) server for Tokium — lets AI agents like Claude and GPT use Tokium as a native tool.

Why use this?

The SDK (@tokium-labs/sdk) is for developers building apps — you write the code that decides which APIs to call.

The MCP server is different. It gives the AI agent itself the ability to discover and use any API on Tokium autonomously, without the developer writing integration code.

With MCP configured, an AI agent can:

1. Browse the Tokium marketplace to find the right API for any task
2. Read the API documentation to understand how to use it
3. Call the API and pay for it from its wallet
4. Monitor its balance and usage

Example: You tell Claude "scrape this website for me" — Claude searches Tokium's proxies, finds a scraping API, reads its docs, calls it, and returns the result. Zero code written by the developer.

Setup

Claude Desktop / Claude Code

Agent tools only (browse, call proxies, check balance):

{
  "mcpServers": {
    "tokium": {
      "command": "npx",
      "args": ["-y", "@tokium-labs/mcp"],
      "env": { "TOKIUM_API_KEY": "sk-live-..." }
    }
  }
}

Agent + owner tools (also manage agents, top-up, auto top-up):

{
  "mcpServers": {
    "tokium": {
      "command": "npx",
      "args": ["-y", "@tokium-labs/mcp"],
      "env": {
        "TOKIUM_API_KEY": "sk-live-...",
        "TOKIUM_EMAIL": "[email protected]",
        "TOKIUM_PASSWORD": "..."
      }
    }
  }
}

Or use a pre-obtained JWT token instead:

{
  "env": {
    "TOKIUM_API_KEY": "sk-live-...",
    "TOKIUM_TOKEN": "eyJhbG..."
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | TOKIUM_API_KEY | Yes | Your Tokium agent API key | | TOKIUM_EMAIL | No | Owner email (enables owner tools) | | TOKIUM_PASSWORD | No | Owner password (used with TOKIUM_EMAIL) | | TOKIUM_TOKEN | No | JWT token (alternative to email/password) |

Available Tools

Agent Tools

Always available — require TOKIUM_API_KEY.

| Tool | Description | |------|-------------| | tokium_agent_info | Get current agent details (name, balance, limits) | | tokium_list_proxies | Browse available API proxies | | tokium_get_proxy | Get proxy details and endpoints | | tokium_list_categories | List proxy categories | | tokium_get_proxy_docs | Get a proxy's skill.md documentation | | tokium_call_proxy | Execute an API call through a proxy | | tokium_get_balance | Get wallet balance and recent transactions | | tokium_get_stats | Get usage statistics | | tokium_platform_skill | Get Tokium platform documentation |

Owner Tools

Only available when owner credentials are provided (TOKIUM_TOKEN or TOKIUM_EMAIL + TOKIUM_PASSWORD).

| Tool | Description | |------|-------------| | tokium_list_agents | List all agents with balances and spend limits | | tokium_create_agent | Create a new agent (returns API key — shown only once) | | tokium_top_up_agent | Create a Stripe checkout link to fund an agent | | tokium_get_auto_topup | Get auto top-up settings for an agent | | tokium_update_auto_topup | Enable/disable auto top-up with threshold and amount |

License

MIT