Hydracept

com.hydraceptPublished by hydracept.comOfficial publisherv0.5.7Updated Nov 13, 2026

Directory-safe MCP: quote and run text/domain jobs with OAuth, receipts, BYOK.

VerifiedStreamable HTTPWeb executableCloud & InfrastructureMedia & DesignAI & ML

Overview

AI-generated overview

Hydracept is an execution control plane that lets an assistant discover, quote and run external capability jobs such as text, image, audio, video, 3D, domains…

What you can do
  • Discover available capabilities and find one matching a task
  • Submit capability jobs, wait for them to finish and fetch artifacts
  • Retrieve job receipts and track budgets and BYOK connections
  • Run text, reasoning, image, audio, video, 3D, domain and compute jobs through one API
  • Choose between a full tool list and a compact eleven-tool lifecycle profile
When to use it
Useful when an assistant needs to run paid or long-running external jobs, such as generating game assets or media, and you want quotes, durable job tracking, receipts and budget control rather than direct provider calls.
Requirements
Either the hosted remote endpoint with OAuth, or the local PyPI package run with uvx over stdio. The stdio path needs HYDRACEPT_API_KEY (or project secrets after init) and a workspace initialized with the CLI; the hosted remote uses OAuth instead of the key. Network access to the Hydracept API is required.
Before you install
Jobs can cost money: managed inference is billed at provider cost plus a service fee, and BYOK is billed by your own provider. The server can submit jobs that spend budget and write workspace files under .hydracept/. The README advises against pasting workspace API keys into IDE plugin config when stdio binding is available.

Installation

In SourceWeft

  1. Open Hydracept in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.hydracept%2Fhydracept/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "hydracept": {
      "type": "http",
      "url": "https://api.hydracept.com/mcp/claude"
    }
  }
}

README

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

SurfaceCommand
Python CLI & SDKpip install -U hydracept
TypeScriptnpm install @hydracept/sdk
.NETdotnet 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

bash
pip install -U hydraceptpython -m hydracept init --apply --yes --jsonpython -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):

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

Python SDK (after init binds the workspace):

python
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):

bash
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:

bash
python -m hydracept init --apply --yes --json   # binds MCP to workspace secrets; reload MCP if promptedpython -m hydracept mcp serve                   # stdio serverpython -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

TopicLink
Docs homedocs.hydracept.com
Quick start (detailed)Quick Start
Capabilities & jobsCapabilities, Jobs & receipts
Image productionImage production
UnityUnity integration
BYOK & billingConnections / BYOK, Billing
LLM-oriented summaryhydracept.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.

Source: README.md at commit f9876c1

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

7
  1. v0.5.7LatestNov 13, 2026
  2. v0.5.6Nov 12, 2026
  3. v0.5.5Nov 12, 2026
  4. v0.5.4Oct 29, 2026
  5. v0.5.3Oct 20, 2026
  6. v0.5.2Oct 13, 2026
  7. v0.4.4Sep 26, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Hydracept integrations