Hydracept MCP server
Commit Nov 12, 2026Provides an execution control plane for AI agents to access external capabilities like text, reasoning, image, audio, video, and compute through a single API.
Also known as zencodeinc/hydracept-public, vscode
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.5.6
- Last commit
- Nov 12, 2026
- License
- MIT
What is Hydracept MCP?
Hydracept provides an execution control plane for AI agents to access external capabilities like text, reasoning, image, audio, video, and compute through a single API.
Summary generated from the project's README
About Hydracept MCP server
Managing external capabilities like image generation, audio, video, and compute through a single interface is what Hydracept enables for AI agents and software. Developers can use this execution control plane to access diverse tools including reasoning, 3D, and domain services via a unified API. It supports various integration methods such as a Python CLI, TypeScript SDK, .NET package, and a dedicated Unity integration for game development workflows.
Users can set up the environment locally using the `hydracept init` command to bind secrets to a workspace or connect via a hosted MCP endpoint using a bearer token. The system provides features like durable jobs, artifacts, receipts, and budget management. It also supports Bring Your Own Key (BYOK) models with no service fee, while managed inference options include a 6% service fee. For those using Cursor or Claude Code, the server can be run as a stdio MCP server to automate complex tasks like generating game assets directly into Unity.
What you can do with it
- 1Generate game assets via AIAn AI agent can create visual assets like slime icons and move them directly into a Unity project.
- 2Manage inference costs and budgetsUsers can control spending by using their own API keys or utilizing deferred processing for text jobs at reduced rates.
Written from the project's README. Every use case is checked against a quote from it.
How to install Hydracept MCP
Formats verified 10 Nov 2026Install Hydracept MCP in Claude Code
$ claude mcp add --transport http vscode https://api.hydracept.com/mcp/vscodeInstall Hydracept MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"vscode": {
"url": "https://api.hydracept.com/mcp/vscode"
}
}
}Install Hydracept MCP in VS Code
.vscode/mcp.json
{
"servers": {
"vscode": {
"type": "http",
"url": "https://api.hydracept.com/mcp/vscode"
}
}
}Install Hydracept MCP in Codex
~/.codex/config.toml
[mcp_servers.vscode] url = "https://api.hydracept.com/mcp/vscode"
Install Hydracept MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"vscode": {
"httpUrl": "https://api.hydracept.com/mcp/vscode"
}
}
}README
View on GitHubHydracept
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/mcpwith bearerHYDRACEPT_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 packagehydracept(CLI, SDK, local MCP)clients/typescript— npm@hydracept/sdkclients/csharp— NuGetHydracept.Clientpackages/unity— Unity Editor packagepublic/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.
Hydracept MCP questions
How do I add Hydracept MCP to Claude Code?
Run claude mcp add --transport http vscode https://api.hydracept.com/mcp/vscode in your terminal. Add --scope user to make it available in every project.
How do I add Hydracept MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What are the pricing options for Hydracept?
There is a free plan for individuals, while paid plans offer more capacity. Managed inference incurs a 6% service fee, but BYOK (Bring Your Own Key) has a 0% fee.
Can I use Hydracept for game development?
Yes, it is commonly used for games, such as generating AI game assets from Cursor or Claude Code into Unity.