meshive-mcp

Remote MCP server for the Meshive GPU Cloud. Connect it to Claude Code, Codex, Cursor, or any MCP-capable agent and manage your Meshive account, workspaces, pods, storage, GPUs, templates, serverless deployments, and hosted machines in natural language.

The server is a thin tool layer over the meshive Python SDK. It holds no state and stores no credentials: your API key travels in the request header and is forwarded to the Meshive API as-is.

Connect your agent

You need a Meshive API key. Create one in the console (workspace Settings → Secret). Keys look like meshive_ followed by 64 characters.

The server URL is https://mcp.meshive.ai/mcp. Every client below sends the key as Authorization: Bearer <key>.

Claude Code

claude mcp add --transport http meshive https://mcp.meshive.ai/mcp \
  --header "Authorization: Bearer meshive_..."

Codex CLI — add to ~/.codex/config.toml:

[mcp_servers.meshive]
url = "https://mcp.meshive.ai/mcp"
bearer_token_env_var = "MESHIVE_API_KEY"

and export MESHIVE_API_KEY=meshive_... in your shell.

Cursor / other mcp.json clients

{
  "mcpServers": {
    "meshive": {
      "url": "https://mcp.meshive.ai/mcp",
      "headers": { "Authorization": "Bearer meshive_..." }
    }
  }
}

See docs/clients.md for more clients and for stdio-only clients.

Related MCP server: Partiri Cloud MCP Server

Tools

All tools in this version are read-only. gpus also works without an API key (prices only).

Lists are paged (20 per call by default, 100 max) with an opaque cursor. Errors come back as {"code", "message", "next_step"} so the agent knows what to do next.

Run it yourself

pip install .
meshive-mcp                      # HTTP on 127.0.0.1:8080, endpoint /mcp, health at /healthz
meshive-mcp --transport stdio    # local stdio for development; reads MESHIVE_API_KEY

Environment variables:

Docker (public image, built from the real branch):

docker run -p 8080:8080 meshive/meshive-mcp

Or build it yourself with docker build -t meshive-mcp ..

Development

python -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
pytest

The test suite drives the tools through an in-process MCP client and through the HTTP transport with a fake SDK client, so it needs no network and no API key.

License

Apache-2.0