inferhive-mcp

MCP server for InferHive, the collaborative GPU lending and LLM inference platform by Impulsate. It lets an AI assistant (Claude Code, Claude Desktop or any MCP client) check your balance, list and rent GPUs, reserve them, stop instances, write your kubeconfig and call the OpenAI-compatible LLM gateway, all paid in processing coins (PC), the platform's credits.

It is built on the inferhive SDK and uses the same credentials. Requires Python 3.12+. The portal lives at https://inferhive.impulsate.lat.

Install and log in

pip install inferhive        # the SDK and CLI, used to log in
inferhive login --scope rent # approve in the browser; use --scope read to only look

inferhive login stores a platform key (pak_...) in ~/.config/pcoin/platform_key (mode 0600). The MCP server reads it from there; you do not need to install the server yourself if your client runs it with uvx.

Add it to your client

Claude Code:

claude mcp add inferhive -- uvx inferhive-mcp
# without a browser login: a pak_ key created in the portal (API keys)
claude mcp add inferhive -e INFERHIVE_API_KEY=pak_... -- uvx inferhive-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "inferhive": { "command": "uvx", "args": ["inferhive-mcp"] }
  }
}

inferhive-mcp speaks stdio. inferhive-mcp --http [--port N] serves streamable HTTP on 127.0.0.1 instead; it has no authentication of its own, so never expose it to a network.

Tools

Credentials

Resolved like the SDK, in this order:

1. Platform key pak_...: INFERHIVE_API_KEY, or ~/.config/pcoin/platform_key from inferhive login. Its scope is set at login: read only looks; rent can reserve, rent and spend PC. If it expired or was revoked, run inferhive login again.
2. PCOIN_TOKEN: a Cloudflare Access session token (legacy browser session).
3. PCOIN_API_KEY or ~/.config/pcoin/api_key: an LLM key pck_..., used only by llm_chat. Create it in the portal (LLM API) and save it with inferhive llm keys save.

Create and revoke LLM keys in the portal (LLM API): no platform key can manage keys, so the server only lists them. PCOIN_CONFIG_DIR changes the configuration folder.

Safety

• Reserving and renting require confirm=true: the assistant should show you the cost and ask before passing it. Without it, nothing is written.
• cancel_reservation, release_gpu and stop_instance are marked as destructive; configure your client to ask for approval on them.
• rent_instance refuses community nodes unless accept_community=true: the owner of such a node is root on it and can see what runs there.
• Secrets are never logged or returned. Rental responses never include the app token (Jupyter, vLLM).
• For automation, use a pak_ key with the smallest scope (read if it only looks) and an expiry, and revoke it from the portal when done.

Changes

• 0.2.0: removes create_llm_key and revoke_llm_key, which a platform key can never use; manage LLM keys in the portal. 14 tools.
• 0.1.0: first release, with 16 tools.

License

MIT. See LICENSE.