HopBase MCP server
OfficialThis server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
HopBase MCP server
HopBase is an AI gateway that serves Claude, GPT, Gemini, DeepSeek and other text, image and video models through one base URL. This MCP server lets a coding agent look up what its HopBase API key can do: which models it can call, their limits, its balance and its usage.
Endpoint:
https://api.hop-base.com/mcpTransport: Streamable HTTP, stateless, POST only (one JSON-RPC message per request; no SSE stream or batch requests)
Authentication:
Authorization: Bearer <key>orx-api-key: <key>, with the same API key you use for model calls. Required to call a tool; listing the tools needs no keyScope: read-only; every result covers only the key in use
This is a hosted service and its source is not published. This repository holds the MCP registry manifest (server.json) and client configs.
Tools
Tool | Returns |
| Models this key can call, with effective prices |
| For one model ID: whether this key can call it, plus the endpoints, request parameters, and limits documented for it, with links to the source pages |
| The docs sections that best match a query (model ID, parameter name, error code), each with URL and snippet; |
| Account balance and this key's spend-cap usage, in USD |
| Key name, groups, spend cap, concurrency cap, expiry, and status |
| Requests, tokens, and billed cost for this key; last 7 days by default, up to 92 days |
get_model_limits and search_docs read the published docs and refresh at most once an hour. The linked docs page is authoritative: a limit missing from a result does not mean there is none.
Related MCP server: depot-mcp
Setup
You need a HopBase API key: create one in the console and export it as HOPBASE_API_KEY.
Claude Code
claude mcp add --transport http hopbase https://api.hop-base.com/mcp \
--header "Authorization: Bearer $HOPBASE_API_KEY"The shell expands the variable when you run the command, so the key is saved in your local Claude Code configuration. For a shared project configuration, put examples/claude-code.mcp.json in the project as .mcp.json instead; Claude Code expands ${HOPBASE_API_KEY} at startup, so the file holds no key.
Cursor
Save examples/cursor.mcp.json as .cursor/mcp.json in the project, or as ~/.cursor/mcp.json for every project:
{
"mcpServers": {
"hopbase": {
"url": "https://api.hop-base.com/mcp",
"headers": { "Authorization": "Bearer ${env:HOPBASE_API_KEY}" }
}
}
}Other clients
Any client that supports remote Streamable HTTP servers with a custom header can connect: point it at the endpoint and send the Authorization header above.
Good to know
The key decides what MCP sees.
list_modelsandget_model_limitssee only the groups of the key you configure. To inspect another model family, add its group to the key, or register a second server entry with a key that includes it.Model calls do not go through MCP. Keep inference on the regular API endpoints (
https://api.hop-base.com/v1: OpenAI Chat Completions and Responses, Anthropic Messages, native Gemini, and the image and video task endpoints).Calling a tool needs a key. The handshake (
initialize) andtools/listanswer without credentials, so clients and directories can discover the tools;tools/callwithout a key returns 401.
Links
Coding-agent guide and MCP docs: https://hop-base.com/en/docs/getting-started/ai-agent
Machine-readable integration contract: https://hop-base.com/llms.txt
Support: support@hop-base.com
License
The files in this repository are released under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Related MCP Connectors
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Read-only search and Markdown pages from the OpenPlanr docs, for coding agents.
LLM API discovery: access conditions, dated costs, sampled checks and keyless configs. Read-only.
Read-only ChinaAPI model catalogue, price snapshot, cost estimates and request recipes.
Related MCP Servers
AlicenseNot gradedqualityCmaintenanceEnables coding agents and chat clients to inspect proxy tokens, usage, pools, geo targeting, and build ready-to-use proxy connection URLs via the Litport account API, while remaining read-only.358 npmMIT- AlicenseNot gradedqualityCmaintenanceEnables read-only inspection of Depot CI failures, job logs, GitHub Actions jobs on Depot runners, and container builds through the Depot API, so agents can diagnose issues without installing the Depot CLI.66 npmMIT
- AlicenseBqualityBmaintenanceGives coding agents read-only access to an AI-SPM backend's flagged issues, inventory, and remediation guidance so they can fix the affected code, along with guardrail policies, LLM-interaction analytics, cost-optimization analyses, and red-teaming evaluation results.37Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables coding agents to search public documentation, retrieve SDK snippets with verification status, and access published pricing and an llms.txt resource in a read-only, credential-free way.MIT