TokenOracle MCP Server

Name: TokenOracle MCP Server
Author: com.guffeyholdings

com.guffeyholdings/token-oracle

Repository Registry

What is the TokenOracle MCP server?

Hosted MCP server for LLM cost estimation, model comparison, and budget-aware routing.

How to install TokenOracle

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

TOKEN_ORACLE_API_KEY
required
secret
Hosted API key for TokenOracle
TOKEN_ORACLE_BASE_URL
Optional override for the hosted TokenOracle MCP endpoint
TOKEN_ORACLE_SUBJECT
Optional end-user subject forwarded to the hosted service
X-API-Key
required
secret
Hosted API key for TokenOracle
X-Token-Oracle-Subject
Optional end-user subject forwarded to the hosted service

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "token-oracle": {
      "command": "npx",
      "args": [
        "-y",
        "token-oracle-mcp"
      ],
      "env": {
        "TOKEN_ORACLE_API_KEY": "<YOUR_TOKEN_ORACLE_API_KEY>",
        "TOKEN_ORACLE_BASE_URL": "<YOUR_TOKEN_ORACLE_BASE_URL>",
        "TOKEN_ORACLE_SUBJECT": "<YOUR_TOKEN_ORACLE_SUBJECT>",
        "X-API-Key": "<YOUR_X_API_KEY>",
        "X-Token-Oracle-Subject": "<YOUR_X_TOKEN_ORACLE_SUBJECT>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "token-oracle": {
      "command": "npx",
      "args": [
        "-y",
        "token-oracle-mcp"
      ],
      "env": {
        "TOKEN_ORACLE_API_KEY": "<YOUR_TOKEN_ORACLE_API_KEY>",
        "TOKEN_ORACLE_BASE_URL": "<YOUR_TOKEN_ORACLE_BASE_URL>",
        "TOKEN_ORACLE_SUBJECT": "<YOUR_TOKEN_ORACLE_SUBJECT>",
        "X-API-Key": "<YOUR_X_API_KEY>",
        "X-Token-Oracle-Subject": "<YOUR_X_TOKEN_ORACLE_SUBJECT>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "token-oracle": {
      "command": "npx",
      "args": [
        "-y",
        "token-oracle-mcp"
      ],
      "env": {
        "TOKEN_ORACLE_API_KEY": "<YOUR_TOKEN_ORACLE_API_KEY>",
        "TOKEN_ORACLE_BASE_URL": "<YOUR_TOKEN_ORACLE_BASE_URL>",
        "TOKEN_ORACLE_SUBJECT": "<YOUR_TOKEN_ORACLE_SUBJECT>",
        "X-API-Key": "<YOUR_X_API_KEY>",
        "X-Token-Oracle-Subject": "<YOUR_X_TOKEN_ORACLE_SUBJECT>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "token-oracle": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "token-oracle-mcp"
      ],
      "env": {
        "TOKEN_ORACLE_API_KEY": "<YOUR_TOKEN_ORACLE_API_KEY>",
        "TOKEN_ORACLE_BASE_URL": "<YOUR_TOKEN_ORACLE_BASE_URL>",
        "TOKEN_ORACLE_SUBJECT": "<YOUR_TOKEN_ORACLE_SUBJECT>",
        "X-API-Key": "<YOUR_X_API_KEY>",
        "X-Token-Oracle-Subject": "<YOUR_X_TOKEN_ORACLE_SUBJECT>"
      }
    }
  }
}

Claude Code

claude mcp add token-oracle --env TOKEN_ORACLE_API_KEY=<YOUR_TOKEN_ORACLE_API_KEY> --env TOKEN_ORACLE_BASE_URL=<YOUR_TOKEN_ORACLE_BASE_URL> --env TOKEN_ORACLE_SUBJECT=<YOUR_TOKEN_ORACLE_SUBJECT> --env X-API-Key=<YOUR_X_API_KEY> --env X-Token-Oracle-Subject=<YOUR_X_TOKEN_ORACLE_SUBJECT> -- npx -y token-oracle-mcp