How do I install Hydracept?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Hydracept need an API key?

The publisher lists these environment variables: HYDRACEPT_API_KEY, HYDRACEPT_MCP_TOOL_PROFILE.

What transport does Hydracept use?

Hydracept is reached over HTTP.

When was Hydracept last checked?

Last checked 2026-11-12. Directory-safe MCP: quote and run text/domain jobs with OAuth, receipts, BYOK.

Hydracept MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.hydracept.com/mcp/claude

Credentials from the publisher

HYDRACEPT_API_KEY — Hydracept API key from https://hydracept.com/start (or use project secrets after init). Stdio only — the hosted remote uses OAuth, not this key.
HYDRACEPT_MCP_TOOL_PROFILE — Stdio MCP tools/list for the process lifetime: full (default when unset) or compact (eleven lifecycle tools). Hosted POST /mcp defaults to compact for new API keys; POST /mcp/full always lists all specialists. The registry remote (/mcp/claude) is the directory-safe OAuth surface.

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.hydracept-hydracept https://api.hydracept.com/mcp/claude

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.hydracept-hydracept": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.hydracept.com/mcp/claude"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Hydracept

Hydracept is an execution control plane for software and AI agents that need external capabilities—text, reasoning, image, audio, video, 3D, domains, and compute—through one API with discovery, quotes, durable jobs, artifacts, receipts, budgets, and BYOK. Games and media are common examples; a headline workflow is AI game assets from Cursor or Claude Code into Unity (workflow overview).

Pricing (summary): Free plan ($0/mo) for individuals; paid plans add capacity. BYOK at 0% Hydracept fee; managed inference is provider cost + 6% service fee (actual usage, no per-call minimum). Eligible durable text jobs can use deferred processing at 50% of standard token rates. Details: hydracept.com/pricing and Billing docs.

Install

Surface	Command
Python CLI & SDK	`pip install -U hydracept`
TypeScript	`npm install @hydracept/sdk`
.NET	`dotnet add package Hydracept.Client`
Unity (UPM git)	`com.hydracept.unity` via Git URL — see Unity integration (OpenUPM listing pending owner submit)

Public HTTP API: https://api.hydracept.com · OpenAPI: hydracept-v1.json · Agent context: GET https://api.hydracept.com/v1/agent-context

Bootstrap

pip install -U hydracept
python -m hydracept init --apply --yes --json
python -m hydracept doctor

Studio (browser): app.hydracept.com/login. For CI or headless use, set HYDRACEPT_API_KEY and run the same init command with --ci when you need setup grants. Workspace files live under .hydracept/ — see Authentication.

Minimal example

One-shot image generation (composes init when the workspace can be bootstrapped):

python -m hydracept run image.generate.v1 --prompt "transparent 1024x1024 blue slime icon" --json

Python SDK (after init binds the workspace):

from hydracept.client import HydraceptClient

client = HydraceptClient.from_workspace()
job = client.submit_capability_job(
    "image.generate.v1",
    {
        "input": {"prompt": "cute slime icon, flat game art"},
        "execution": {"executionPreference": "automatic"},
        "idempotencyKey": "demo-1",
    },
)
finished = client.wait_for_job(job["jobId"])
receipt = client.get_job_receipt(job["jobId"])

Discover capabilities live (do not hard-code keys from this README):

python -m hydracept capabilities find "generate an image"
curl -sS -H "Authorization: Bearer $HYDRACEPT_API_KEY" https://api.hydracept.com/v1/capabilities

More examples: public/examples/.

MCP (Cursor & Claude Code)

In a project checkout, stdio MCP is the default after init:

python -m hydracept init --apply --yes --json   # binds MCP to workspace secrets; reload MCP if prompted
python -m hydracept mcp serve                   # stdio server
python -m hydracept agents install --auto       # Cursor / Claude Code plugin + hooks

Plugin & install links: hydracept.com/plugin
Hosted MCP (no repo checkout): https://api.hydracept.com/mcp with bearer HYDRACEPT_API_KEY
MCP Registry name: com.hydracept/hydracept

Do not paste workspace API keys into IDE plugin config when stdio bind is available. Full agent guide: Coding Agents.

Documentation

Topic	Link
Docs home	docs.hydracept.com
Quick start (detailed)	Quick Start
Capabilities & jobs	Capabilities, Jobs & receipts
Image production	Image production
Unity	Unity integration
BYOK & billing	Connections / BYOK, Billing
LLM-oriented summary	hydracept.com/llms.txt
Product manifest	/.well-known/hydracept.json

Repository layout

clients/python — PyPI package hydracept (CLI, SDK, local MCP)
clients/typescript — npm @hydracept/sdk
clients/csharp — NuGet Hydracept.Client
packages/unity — Unity Editor package
public/docs — source for docs.hydracept.com (Quick Start content; this root README is the GitHub front door)

License

MIT — see LICENSE. Package metadata on PyPI, npm, and NuGet also lists MIT.