English Français العربية

Hydracept

Registre officiel Productivité

Hosted MCP for Hydracept: discover capabilities, run jobs, receipts, BYOK or managed billing.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http hydracept 'https://api.hydracept.com/mcp' --header 'Authorization: <Authorization>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hydracept": {
            "type": "http",
            "url": "https://api.hydracept.com/mcp",
            "headers": {
                "Authorization": "<Authorization>"
            }
        }
    }
}
PYPI package hydracept
Claude Code 
claude mcp add hydracept -e 'HYDRACEPT_API_KEY=<your hydracept_api_key>' -e 'HYDRACEPT_MCP_TOOL_PROFILE=<HYDRACEPT_MCP_TOOL_PROFILE>' -- uvx hydracept==0.5.3 mcp serve
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hydracept": {
            "command": "uvx",
            "args": [
                "hydracept==0.5.3",
                "mcp",
                "serve"
            ],
            "env": {
                "HYDRACEPT_API_KEY": "<your hydracept_api_key>",
                "HYDRACEPT_MCP_TOOL_PROFILE": "<HYDRACEPT_MCP_TOOL_PROFILE>"
            }
        }
    }
}

Variables d'environnement

  • HYDRACEPT_API_KEY obligatoire secret Hydracept API key from https://hydracept.com/start (or use project secrets after init)
  • 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.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Hydracept
  2. Install
  3. Bootstrap
  4. Minimal example
  5. MCP (Cursor & Claude Code)
  6. Documentation
  7. Repository layout
  8. License

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

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

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.

Questions fréquentes

Qu'est-ce que Hydracept ?

Hosted MCP for Hydracept: discover capabilities, run jobs, receipts, BYOK or managed billing.

Comment installer Hydracept ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http hydracept 'https://api.hydracept.com/mcp' --header 'Authorization: <Authorization>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Hydracept ?

Oui. Il attend HYDRACEPT_API_KEY, Authorization, à renseigner dans sa configuration.

Hydracept est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Hydracept ?

Il est publié par zencodeinc. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.