Tovanix

MCP Access

Connect your Tovanix account to any MCP-capable AI client. The endpoint is https://tovanix.com/api/mcp/rpc — stateless Streamable HTTP that accepts POST only.

Authentication: Authorization: Bearer <credential>, or the X-MCP-Key header; credentials start with mcp_live_ and are shown once
Permissions: every capability is off until you enable it; tools/list returns only enabled ones, named tovanix_ plus the capability name
Spending and irreversible tools require a totp_code one-time code and respect per-call and daily caps
Source IP allow lists, expiry dates and a default rate limit of 120 calls per minute (up to 600)
Three resources (capability catalog, account overview, platform guide) and three prompts (account check-up, spending report, expiry check)
Errors: 401 invalid credential, 403 source or account state not allowed, 405 not POST, 413 request too large
Creating a credential requires reading and accepting the MCP Access Agreement; content and actions sent in your name are your responsibility
Besides spending and irreversible actions, key settings such as callback URLs, public posts and public bucket access also require a one-time code; AI posts, support messages, emails and live Telegram reads have per-account rate limits, repeated posts and support messages are rejected, and support messages are labelled “Sent via AI assistant”

Connect Tovanix MCP from each AI tool

Replace <YOUR_MCP_CREDENTIAL> with the MCP credential you created in the console.

Claude Code — Run in a terminal

claude mcp add --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"

Codex — Config file: ~/.codex/config.toml

[mcp_servers.tovanix]
url = "https://tovanix.com/api/mcp/rpc"
bearer_token_env_var = "TOVANIX_MCP_CREDENTIAL"

Cursor — Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "tovanix": {
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

GitHub Copilot (VS Code) — Config file: .vscode/mcp.json

{
  "servers": {
    "tovanix": {
      "type": "http",
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer ${input:tovanix-credential}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "tovanix-credential",
      "description": "Tovanix MCP credential",
      "password": true
    }
  ]
}

Gemini CLI — Config file: ~/.gemini/settings.json

{
  "mcpServers": {
    "tovanix": {
      "httpUrl": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

OpenCode — Config file: ~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tovanix": {
      "type": "remote",
      "url": "https://tovanix.com/api/mcp/rpc",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Qwen Code — Run in a terminal

qwen mcp add --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"

Kimi Code CLI — Config file: ~/.kimi-code/mcp.json

{
  "mcpServers": {
    "tovanix": {
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

CodeBuddy Code — Run in a terminal

codebuddy mcp add --scope user --transport http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" tovanix https://tovanix.com/api/mcp/rpc

Qoder CLI — Config file: ~/.qoder/settings.json

{
  "mcpServers": {
    "tovanix": {
      "type": "streamable-http",
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Kiro — Config file: ~/.kiro/settings/mcp.json

{
  "mcpServers": {
    "tovanix": {
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Trae — Config file: .trae/mcp.json

{
  "mcpServers": {
    "tovanix": {
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Trae CN — Config file: .trae/mcp.json

{
  "mcpServers": {
    "tovanix": {
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Trae CLI — Config file: trae_cli.yaml

mcp_servers:
  - name: "tovanix"
    url: "https://tovanix.com/api/mcp/rpc"
    type: "http"
    headers:
      Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"

GitHub Copilot CLI — Run in a terminal

copilot mcp add --transport http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" tovanix https://tovanix.com/api/mcp/rpc

Cline — Config file: cline_mcp_settings.json

{
  "mcpServers": {
    "tovanix": {
      "type": "streamableHttp",
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Kilo Code — Config file: ~/.config/kilo/kilo.jsonc

{
  "mcp": {
    "tovanix": {
      "type": "remote",
      "url": "https://tovanix.com/api/mcp/rpc",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Continue — Config file: ~/.continue/config.yaml

mcpServers:
  - name: tovanix
    type: streamable-http
    url: https://tovanix.com/api/mcp/rpc
    requestOptions:
      headers:
        Authorization: Bearer <YOUR_MCP_CREDENTIAL>

Zed — Config file: ~/.config/zed/settings.json

{
  "context_servers": {
    "tovanix": {
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Junie — Config file: ~/.junie/mcp/mcp.json

{
  "mcpServers": {
    "tovanix": {
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Amp — Config file: ~/.config/amp/settings.json

{
  "amp.mcpServers": {
    "tovanix": {
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Goose — Config file: ~/.config/goose/config.yaml

extensions:
  tovanix:
    enabled: true
    type: streamable_http
    name: tovanix
    uri: https://tovanix.com/api/mcp/rpc
    headers:
      Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
    timeout: 300

Augment (Auggie) — Run in a terminal

auggie mcp add tovanix --transport http --url https://tovanix.com/api/mcp/rpc --header "Authorization:Bearer <YOUR_MCP_CREDENTIAL>"

Factory Droid — Run in a terminal

droid mcp add tovanix https://tovanix.com/api/mcp/rpc --type http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" --no-oauth

Crush — Config file: ~/.config/crush/crushrc

mcp add tovanix --type http --url https://tovanix.com/api/mcp/rpc --header Authorization "Bearer <YOUR_MCP_CREDENTIAL>"

Warp — Paste in the app settings

{
  "tovanix": {
    "url": "https://tovanix.com/api/mcp/rpc",
    "headers": {
      "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
    }
  }
}

Windsurf — Config file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tovanix": {
      "serverUrl": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Claude (web / desktop) — Enter the address in the app and add an Authorization header (Bearer + credential)
```
https://tovanix.com/api/mcp/rpc
```

LM Studio — Config file: mcp.json

{
  "mcpServers": {
    "tovanix": {
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Dify — Enter the address in the app and add an Authorization header (Bearer + credential)
```
https://tovanix.com/api/mcp/rpc
```
Coze — Enter the address in the app and add an Authorization header (Bearer + credential)
```
https://tovanix.com/api/mcp/rpc
```
n8n — Enter the address in the app and add an Authorization header (Bearer + credential)
```
https://tovanix.com/api/mcp/rpc
```

Other MCP clients — Paste in the app settings

{
  "mcpServers": {
    "tovanix": {
      "url": "https://tovanix.com/api/mcp/rpc",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
      }
    }
  }
}

Frequently Asked Questions

Why does tools/list return an empty list?

The credential has no capabilities enabled yet. Enable the ones you need under “MCP Access” in the console and reconnect.

Why are spending tools always refused?

Check three things: whether the credential’s spend caps are still the default 0, whether two-factor authentication is on, and whether the daily allowance is used up.

Loading…