Hydracept

Official35 tools

by zencodeinc · Python

Execution control plane for agents: capabilities, durable jobs, budgets, receipts, and BYOK.

com.hydracept/hydracept — MCP Server

The com.hydracept/hydracept MCP server provides an execution control plane for agents. It covers agent capabilities, durable jobs, budgets, receipts, and support for BYOK (bring your own key). This positions the server around controlling and tracking agent execution rather than providing standalone business logic.

🛠️ Key Features

Capabilities management
Durable job execution
Budgets
Receipts
BYOK support

🚀 Use Cases

Controlling how agents execute
Running long-lived (durable) agent jobs
Enforcing or tracking execution budgets
Producing receipts for executed actions
Using BYOK in agent execution workflows

⚡ Developer Benefits

Clear execution control concepts (capabilities, jobs, budgets)
Durable job handling for agent workloads
Receipt-oriented tracking
BYOK integration for key management needs

⚠️ Limitations

No additional tool, topic, or readme excerpt details were provided.

Topics

byokgamedevunityimage-generationclaude-codecursormcpvideo-generation3d-generationagent-executionagent-toolsai-agent-infrastructureai-capabilitiesai-executionaudio-generationdurable-jobsgame-assetsmulti-providerreceiptssprite-sheet

Captured live from the server via tools/list.

hydracept_status

Session diagnostics for the authenticated API key.

Parameters1

refresh

boolean

optional

Raw schema

{
  "type": "object",
  "properties": {
    "refresh": {
      "default": false,
      "title": "Refresh",
      "type": "boolean"
    }
  },
  "title": "hydracept_statusArguments"
}

hydracept_capabilities

List, find, or describe capabilities. Includes one-shot readiness facts. Text job_async descriptors may include features.deferredProcessing (50% off standard token rates).

Parameters2

key	string	optional
query	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "key": {
      "default": "",
      "title": "Key",
      "type": "string"
    },
    "query": {
      "default": "",
      "title": "Query",
      "type": "string"
    }
  },
  "title": "hydracept_capabilitiesArguments"
}

resolve_capability

Determine whether Hydracept already provides a suitable capability. Does not spend money.

Parameters2

intent	string	required
requirements	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "intent": {
      "title": "Intent",
      "type": "string"
    },
    "requirements": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Requirements"
    }
  },
  "required": [
    "intent"
  ],
  "title": "resolve_capabilityArguments"
}

hydracept_quote_capability

POST /v1/capabilities/{key}/quote. Does not reserve or charge funds. 'input' is an alias for 'body'.

Parameters3

capability_key	string	required
body	any	optional
input	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "capability_key": {
      "title": "Capability Key",
      "type": "string"
    },
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    },
    "input": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Input"
    }
  },
  "required": [
    "capability_key"
  ],
  "title": "hydracept_quote_capabilityArguments"
}

estimate_capability

HTTP alias of hydracept_quote_capability. Same 0.3 retail quote. 'input' is an alias for 'body'.

Parameters3

capability_key	string	required
body	any	optional
input	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "capability_key": {
      "title": "Capability Key",
      "type": "string"
    },
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    },
    "input": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Input"
    }
  },
  "required": [
    "capability_key"
  ],
  "title": "estimate_capabilityArguments"
}

hydracept_invoke

Invoke a synchronous capability (read-only domain/DNS and text). 'input' is an alias for 'body'.

Parameters3

capability_key	string	required
body	any	optional
input	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "capability_key": {
      "title": "Capability Key",
      "type": "string"
    },
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    },
    "input": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Input"
    }
  },
  "required": [
    "capability_key"
  ],
  "title": "hydracept_invokeArguments"
}

hydracept_run

hydracept.run-result.v1 over hosted HTTP. Artifact persist requires stdio MCP in a checkout. 'input' is an alias for 'body'.

Parameters7

capability_key	string	required
body	any	optional
wait	boolean	optional
timeout	any	optional
max_cost	any	optional
idempotency_key	string	optional
input	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "capability_key": {
      "title": "Capability Key",
      "type": "string"
    },
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    },
    "wait": {
      "default": true,
      "title": "Wait",
      "type": "boolean"
    },
    "timeout": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Timeout"
    },
    "max_cost": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Cost"
    },
    "idempotency_key": {
      "default": "",
      "title": "Idempotency Key",
      "type": "string"
    },
    "input": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Input"
    }
  },
  "required": [
    "capability_key"
  ],
  "title": "hydracept_runArguments"
}

request_capability_quote

Create a capability REQUEST. Commission quotes are human-paid and must not be used as execution.quoteId.

Parameters1

body

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    }
  },
  "title": "request_capability_quoteArguments"
}

get_capability_request_quote

Read the human-paid commission quote for a capability request. Never an execution.quoteId.

Parameters1

request_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "request_id": {
      "title": "Request Id",
      "type": "string"
    }
  },
  "required": [
    "request_id"
  ],
  "title": "get_capability_request_quoteArguments"
}

hydracept_submit_job

Submit a capability job. Omit quoteId; the API seals pricing at admission. Eligible durable text jobs use deferred processing at 50% of standard token rates. Returns nextAction. 'input' is an alias for 'body'.

Parameters4

capability_key	string	required
body	any	optional
idempotency_key	string	optional
input	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "capability_key": {
      "title": "Capability Key",
      "type": "string"
    },
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    },
    "idempotency_key": {
      "default": "",
      "title": "Idempotency Key",
      "type": "string"
    },
    "input": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Input"
    }
  },
  "required": [
    "capability_key"
  ],
  "title": "hydracept_submit_jobArguments"
}

hydracept_job_status

GET /v1/jobs/{jobId} once. If nextAction is poll, wait pollAfterSeconds and call again.

Parameters1

job_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "title": "Job Id",
      "type": "string"
    }
  },
  "required": [
    "job_id"
  ],
  "title": "hydracept_job_statusArguments"
}

hydracept_get_receipt

Fetch sealed receipt summary for a job.

Parameters1

job_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "title": "Job Id",
      "type": "string"
    }
  },
  "required": [
    "job_id"
  ],
  "title": "hydracept_get_receiptArguments"
}

hydracept_download_artifact

Return artifact download metadata and content hash (hosted MCP does not write local files).

Parameters2

job_id	string	required
artifact_id	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "title": "Job Id",
      "type": "string"
    },
    "artifact_id": {
      "title": "Artifact Id",
      "type": "string"
    }
  },
  "required": [
    "job_id",
    "artifact_id"
  ],
  "title": "hydracept_download_artifactArguments"
}

hydracept_smoke

Explicit managed-trial smoke. Same contract as stdio: generation, pricing, SHA-256, PNG alpha.

Parameters4

capability	string	optional
prompt	string	optional
poll_seconds	integer	optional
output_path	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "capability": {
      "default": "image.generate.v1",
      "title": "Capability",
      "type": "string"
    },
    "prompt": {
      "default": "flat 2D game icon of a slime, no plate, no ground, no shadow, centered, simple silhouette",
      "title": "Prompt",
      "type": "string"
    },
    "poll_seconds": {
      "default": 90,
      "title": "Poll Seconds",
      "type": "integer"
    },
    "output_path": {
      "default": "",
      "title": "Output Path",
      "type": "string"
    }
  },
  "title": "hydracept_smokeArguments"
}

hydracept_pinned_run

POST /v1/inference/pinned — exact pin, scientific receipt. Standard processing by default. Opt in with processing=deferred on eligible OpenAI Responses pins (50% Flex). One logical model execution, no truncation rewrite, no Flex→Standard fallback. Pre-inference capacity 429s may retry.

Parameters1

body

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    }
  },
  "title": "hydracept_pinned_runArguments"
}

hydracept_pinned_bulk

POST /v1/inference/pinned/bulk — concurrent pinned items, one logical execution each.

Parameters1

body

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    }
  },
  "title": "hydracept_pinned_bulkArguments"
}

hydracept_pinned_get

GET /v1/inference/pinned/{receipt_id}.

Parameters1

receipt_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "receipt_id": {
      "title": "Receipt Id",
      "type": "string"
    }
  },
  "required": [
    "receipt_id"
  ],
  "title": "hydracept_pinned_getArguments"
}

hydracept_pinned_bulk_get

GET /v1/inference/pinned/bulk/{bulk_id} once. If nextAction is poll, wait pollAfterSeconds and call again.

Parameters1

bulk_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "bulk_id": {
      "title": "Bulk Id",
      "type": "string"
    }
  },
  "required": [
    "bulk_id"
  ],
  "title": "hydracept_pinned_bulk_getArguments"
}

hydracept_manifest_create

POST /v1/provenance/manifests.

Parameters1

body

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    }
  },
  "title": "hydracept_manifest_createArguments"
}

hydracept_manifest_verify

POST /v1/provenance/manifests/{manifest_id}/verify.

Parameters1

manifest_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "manifest_id": {
      "title": "Manifest Id",
      "type": "string"
    }
  },
  "required": [
    "manifest_id"
  ],
  "title": "hydracept_manifest_verifyArguments"
}

hydracept_lockfile_emit

GET /v1/provenance/lockfile?receipt_id=.

Parameters1

receipt_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "receipt_id": {
      "title": "Receipt Id",
      "type": "string"
    }
  },
  "required": [
    "receipt_id"
  ],
  "title": "hydracept_lockfile_emitArguments"
}

hydracept_verify_lockfile

POST /v1/provenance/lockfile/verify.

Parameters1

body

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "body": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    }
  },
  "title": "hydracept_verify_lockfileArguments"
}

hydracept_jobs_find

Find recent, failed, or reusable project jobs without asking the human for a job id.

Parameters4

intent	string	optional
capability_key	string	optional
limit	integer	optional
project_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "intent": {
      "default": "recent",
      "title": "Intent",
      "type": "string"
    },
    "capability_key": {
      "default": "",
      "title": "Capability Key",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "title": "Limit",
      "type": "integer"
    },
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    }
  },
  "title": "hydracept_jobs_findArguments"
}

hydracept_job_inspect

Inspect error, diagnostics, receipt summary, request snapshot, and reuse candidate for one job.

Parameters1

job_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "title": "Job Id",
      "type": "string"
    }
  },
  "required": [
    "job_id"
  ],
  "title": "hydracept_job_inspectArguments"
}

hydracept_project_request_operation

POST a project operation. Hosted MCP does not run the customer repo; a local watcher must execute it.

Parameters5

command	string	required
action_key	string	optional
project_id	string	optional
input	any	optional
context	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "command": {
      "title": "Command",
      "type": "string"
    },
    "action_key": {
      "default": "",
      "title": "Action Key",
      "type": "string"
    },
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    },
    "input": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Input"
    },
    "context": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Context"
    }
  },
  "required": [
    "command"
  ],
  "title": "hydracept_project_request_operationArguments"
}

hydracept_project_get_operation

Poll a project operation. Execution happens in the game checkout, not on this host.

Parameters2

operation_id	string	required
project_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "operation_id": {
      "title": "Operation Id",
      "type": "string"
    },
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    }
  },
  "required": [
    "operation_id"
  ],
  "title": "hydracept_project_get_operationArguments"
}

hydracept_model_adapters

List the bound project's registered model adapters, semantic aliases, image-generation default, and static routing readiness. Omitted project/environment arguments inherit the authenticated workspace binding. A registered adapter is not necessarily executable; require routingReadiness.routeCompatible before selecting it for generation. credentialAvailability=not_checked means credentials/capacity are still quote-time concerns. New agents should inspect project aliases before searching externally.

Parameters2

project_id	string	optional
environment	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    },
    "environment": {
      "default": "",
      "title": "Environment",
      "type": "string"
    }
  },
  "title": "hydracept_model_adaptersArguments"
}

hydracept_prepare_adapter_selection

Normalize a LoRA picker selection into the exact image.generate.v1 input.adapters contract. This does not submit or spend money. Use hydracept_model_adapters first and select only route-compatible entries.

Parameters1

adapters

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "adapters": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Adapters"
    }
  },
  "title": "hydracept_prepare_adapter_selectionArguments"
}

hydracept_create_adapter_alias

Create a stable semantic project alias for a registered adapter. Omitted project/environment arguments inherit the authenticated workspace binding. Catalog aliases may reference registrations that are not yet executable. Does not generate or spend money.

Parameters5

alias	string	required
adapter_id	string	required
weight	any	optional
project_id	string	optional
environment	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "title": "Alias",
      "type": "string"
    },
    "adapter_id": {
      "title": "Adapter Id",
      "type": "string"
    },
    "weight": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Weight"
    },
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    },
    "environment": {
      "default": "",
      "title": "Environment",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "adapter_id"
  ],
  "title": "hydracept_create_adapter_aliasArguments"
}

hydracept_promote_adapter_alias

Explicitly move a semantic alias to a new registered adapter/weight by creating a new immutable alias version. Omitted project/environment arguments inherit the authenticated workspace binding. Existing recipe bindings do not move. An alias serving as an active generation default must remain route-compatible unless the default is cleared first.

Parameters5

alias	string	required
adapter_id	string	required
weight	any	optional
project_id	string	optional
environment	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "title": "Alias",
      "type": "string"
    },
    "adapter_id": {
      "title": "Adapter Id",
      "type": "string"
    },
    "weight": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Weight"
    },
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    },
    "environment": {
      "default": "",
      "title": "Environment",
      "type": "string"
    }
  },
  "required": [
    "alias",
    "adapter_id"
  ],
  "title": "hydracept_promote_adapter_aliasArguments"
}

hydracept_bind_adapter_alias

Resolve a project alias to an immutable alias-version binding for persistence in a project recipe. Omitted project/environment arguments inherit the authenticated workspace binding. Omit version_id to pin the current version. Recipe pinning is allowed for catalog-only adapters; generation still requires a compatible route.

Parameters4

alias	string	required
version_id	string	optional
project_id	string	optional
environment	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "title": "Alias",
      "type": "string"
    },
    "version_id": {
      "default": "",
      "title": "Version Id",
      "type": "string"
    },
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    },
    "environment": {
      "default": "",
      "title": "Environment",
      "type": "string"
    }
  },
  "required": [
    "alias"
  ],
  "title": "hydracept_bind_adapter_aliasArguments"
}

hydracept_set_adapter_default

Set a route-compatible semantic alias preselected for future image.generate.v1 work. Omitted project/environment arguments inherit the authenticated workspace binding. The default is not silently injected by the API; agents still send the resolved adapters[] selection.

Parameters4

alias	string	required
capability_key	string	optional
project_id	string	optional
environment	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "title": "Alias",
      "type": "string"
    },
    "capability_key": {
      "default": "image.generate.v1",
      "title": "Capability Key",
      "type": "string"
    },
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    },
    "environment": {
      "default": "",
      "title": "Environment",
      "type": "string"
    }
  },
  "required": [
    "alias"
  ],
  "title": "hydracept_set_adapter_defaultArguments"
}

hydracept_clear_adapter_default

Clear the project/environment image adapter default. Omitted project/environment arguments inherit the authenticated workspace binding. This does not alter the alias or its immutable history; clearing an environment override may reveal an inherited project-wide default.

Parameters3

capability_key	string	optional
project_id	string	optional
environment	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "capability_key": {
      "default": "image.generate.v1",
      "title": "Capability Key",
      "type": "string"
    },
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    },
    "environment": {
      "default": "",
      "title": "Environment",
      "type": "string"
    }
  },
  "title": "hydracept_clear_adapter_defaultArguments"
}

hydracept_register_model_adapter

Register a reusable project LoRA without generating or spending money. source_kind must be provider_ref, huggingface, or hydracept_artifact. For huggingface, source_ref is namespace/repository; source_file_path may identify an explicit public .safetensors file. If file path is omitted the repository is cataloged but remains non-executable. When a file path is supplied, Hydracept validates it and freezes the Hub commit. For hydracept_artifact, source_ref is a project artifactId and Hydracept binds its immutable content hash. For provider_ref, source_provider is required. Omitted project/environment arguments inherit the authenticated workspace binding. Inspect sourceHealth and routingReadiness.routeCompatible in the result before quoting generation.

Parameters11

display_name	string	required
source_kind	string	required
source_ref	string	required
base_model_family	string	optional
source_revision	string	optional
source_file_path	string	optional
source_provider	string	optional
recommended_weight	any	optional
trigger_words	any	optional
project_id	string	optional
environment	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "display_name": {
      "title": "Display Name",
      "type": "string"
    },
    "source_kind": {
      "title": "Source Kind",
      "type": "string"
    },
    "source_ref": {
      "title": "Source Ref",
      "type": "string"
    },
    "base_model_family": {
      "default": "flux",
      "title": "Base Model Family",
      "type": "string"
    },
    "source_revision": {
      "default": "",
      "title": "Source Revision",
      "type": "string"
    },
    "source_file_path": {
      "default": "",
      "title": "Source File Path",
      "type": "string"
    },
    "source_provider": {
      "default": "",
      "title": "Source Provider",
      "type": "string"
    },
    "recommended_weight": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Recommended Weight"
    },
    "trigger_words": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Trigger Words"
    },
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    },
    "environment": {
      "default": "",
      "title": "Environment",
      "type": "string"
    }
  },
  "required": [
    "display_name",
    "source_kind",
    "source_ref"
  ],
  "title": "hydracept_register_model_adapterArguments"
}

hydracept_revalidate_model_adapter

Re-check the frozen source identity for a registered adapter without generating or spending money. For Hugging Face this checks the already-pinned commit and file; it never advances a branch or tag. For Hydracept artifacts it rechecks immutable content and safetensors structure. Provider-native refs are opaque and remain declared. Use this when sourceHealth is stale, unavailable, or invalid.

Parameters1

adapter_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "adapter_id": {
      "title": "Adapter Id",
      "type": "string"
    }
  },
  "required": [
    "adapter_id"
  ],
  "title": "hydracept_revalidate_model_adapterArguments"
}

README.md5 KBView on GitHub

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 for individual developers; BYOK at 0% Hydracept fee; managed inference is provider price + 6% service fee where enabled; 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)	`com.hydracept.unity` — see Unity integration

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

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 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.

Install

Tools (35)

hydracept_statushydracept_capabilitiesresolve_capabilityhydracept_quote_capabilityestimate_capabilityhydracept_invokehydracept_runrequest_capability_quote

Configuration

Environment variables

HYDRACEPT_API_KEYrequiredsecret

Hydracept API key from https://hydracept.com/start (or use project secrets after init)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "hydracept": {
      "command": "uvx",
      "args": [
        "hydracept",
        "mcp",
        "serve"
      ],
      "env": {
        "HYDRACEPT_API_KEY": "<YOUR_HYDRACEPT_API_KEY>"
      }
    }
  }
}

com.hydracept/hydracept — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

hydracept_status

hydracept_capabilities

resolve_capability

hydracept_quote_capability

estimate_capability

hydracept_invoke

hydracept_run

request_capability_quote

get_capability_request_quote

hydracept_submit_job

hydracept_job_status

hydracept_get_receipt

hydracept_download_artifact

hydracept_smoke

hydracept_pinned_run

hydracept_pinned_bulk

hydracept_pinned_get

hydracept_pinned_bulk_get

hydracept_manifest_create

hydracept_manifest_verify

hydracept_lockfile_emit

hydracept_verify_lockfile

hydracept_jobs_find

hydracept_job_inspect

hydracept_project_request_operation

hydracept_project_get_operation

hydracept_model_adapters

hydracept_prepare_adapter_selection

hydracept_create_adapter_alias

hydracept_promote_adapter_alias

hydracept_bind_adapter_alias

hydracept_set_adapter_default

hydracept_clear_adapter_default

hydracept_register_model_adapter

hydracept_revalidate_model_adapter

Hydracept

Install

Bootstrap

Minimal example

MCP (Cursor & Claude Code)

Documentation

Repository layout

License

Install

Configuration

Related servers