Hydracept MCP server

Quick Start

<!-- docs:marker:quick-start -->

Hydracept is an execution control plane for software and agents that need external capabilities. Games and media are important examples.

Discovery, quoting, durable jobs, artifacts, receipts, and recoverable project history. BYOK is free; managed inference adds a 6% service fee. Eligible durable text jobs use deferred processing at 50% of standard token rates.

5-minute path

For one asset: python -m hydracept run image.generate.v1 --prompt "..." --json (composes init). For a full walkthrough, see 5-minute game asset. One-off tasks are supported — a single capability call does not require an integration commitment.

Activate

Pick one:

1. CLI bootstrap (recommended): pip install -U hydracept then python -m hydracept init --apply --yes --json. Init infers the current git/workspace project when you are already signed in. Browser project selection is only required when that inference is ambiguous.
2. Studio (browser): app.hydracept.com/login — sign in with GitHub or Google, complete onboarding, then generate in Studio. Manage plans at Studio Billing.
3. Agents / headless: python -m hydracept init --apply --yes --json (or use an existing key out of band with HYDRACEPTAPIKEY).

For coding agents, interactionrequired is a hard human boundary. If presentation.agentAction is presentandyield and stdio MCP exposes hydraceptinteraction_surface, invoke that surface once with the supplied context and stop the turn. Otherwise present action.url verbatim. In either case, stop until the human completes activation; only then run afterCompletion.command / --wait.

See Authentication for workspace files (.hydracept/project.json, secrets, lazy BYOK) and CI mode (init --apply --yes --json --ci).

Public API: https://api.hydracept.com Configuration directory (CLI): .hydracept/ Environment variables: HYDRACEPTAPIURL, HYDRACEPTAPIKEY, HYDRACEPTPROJECT, HYDRACEPTENVIRONMENT

BYOK: Your Hydracept API key authenticates your application, while your provider key pays for inference. Run python -m hydracept smoke (trial budget or BYOK — a real image job) before connecting BYOK — see Connections / BYOK and Billing & plans.

<!-- docs:if packages.cli.releasePublished -->

CLI

pip install -U hydracept

# Prefer the module form if `hydracept` is not on PATH (common on Windows):
python -m hydracept init                              # human — opens connect URL when needed
python -m hydracept init --apply --yes --json         # agents
python -m hydracept init --apply --yes --json --ci    # CI (setup grants)
python -m hydracept doctor
python -m hydracept smoke
python -m hydracept verify
python -m hydracept agent-context

configure and quickstart are deprecated aliases for init. Device login (python -m hydracept login) still works for advanced flows. <!-- docs:endif -->

SDKs

The Python SDK and CLI are available now:

pip install -U hydracept
python -m hydracept --help

The TypeScript SDK is also available:

npm install @hydracept/sdk

<!-- docs:if packages.csharp.registryPublished -->

.NET SDK

<!-- docs:if packages.csharp.registryPublished -->

dotnet add package Hydracept.Client

<!-- docs:endif --> <!-- docs:endif -->

<!-- docs:if !packages.typescript.registryPublished&!packages.python.registryPublished&!packages.csharp.registryPublished -->

HTTP-first integration

Registry packages are still rolling out. Until yours is available, use the public HTTP API and OpenAPI. The curl flow below is the supported clean-room path. <!-- docs:endif -->

Discover capabilities

Shortened. The full README is on GitHub.