Hydracept
PYPI · HYDRACEPT · 2 COMPONENTS · SCANNED SEP 29
Execution control plane for agents: capabilities, durable jobs, budgets, receipts, and BYOK.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security50
- Malware scan not yet available for this package.Unverified
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 3 of 39 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Build provenance is cryptographically sound, but it attests a different repository to the one declared in the registry. Most often the declared URL is simply stale. View diagnostics → Unverified
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 3 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability82
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 2614 tokens (~56/item across 46 items; 45 tools + 1 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage71
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "hydracept_project_watch_once" implies "execute" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 47 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
- Supports UI / widget rendering.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
How do I install the Hydracept MCP server?
Hydracept runs locally as a PyPI package, launched with uvx hydracept. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · hydracept
claude mcp add com-hydracept-hydracept -- uvx hydracept
{
"mcpServers": {
"com-hydracept-hydracept": {
"command": "uvx",
"args": [
"hydracept"
]
}
}
} {
"servers": {
"com-hydracept-hydracept": {
"command": "uvx",
"args": [
"hydracept"
]
}
}
} codex mcp add com-hydracept-hydracept -- uvx hydracept
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-hydracept-hydracept": {
"type": "local",
"command": [
"uvx",
"hydracept"
],
"enabled": true
}
}
} openclaw mcp add com-hydracept-hydracept --command uvx --arg hydracept
mcp_servers:
com-hydracept-hydracept:
command: "uvx"
args: ["hydracept"] {
"McpServers": {
"com-hydracept-hydracept": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"hydracept"
]
}
}
} assistant mcp add com-hydracept-hydracept -t stdio -c uvx -a hydracept
{
"mcpServers": {
"com-hydracept-hydracept": {
"command": "uvx",
"args": [
"hydracept"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 28 Sept 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Sept 26 53
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 29 Sept 2026 · Analysed pypi/hydracept@0.4.4
Provenance Repository mismatch
The attestation is cryptographically sound but binds a different repository to the one the registry declares. Most often the declared URL is simply stale.
| Result | Repository mismatch |
|---|---|
| Ecosystem | pypi |
| Reason | Repository mismatch |
| Discovered via | Registry attestation endpoint |
| Source repo | zencodeinc/hydracept |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/zencodeinc/hydracept/.github/workflows/hydracept-release.yml@refs/heads/main |
| Rekor log index | 2962575061 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:178e92e7363c15558322bdb34e3df73f3504759c6d9ce5f85fd05a76c75e6848 |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | setuptools.build_meta |
Background: Why install scripts are a supply-chain risk →
Dependencies 39 packages
| Packages resolved | 39 |
|---|---|
| Stale | 2 |
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
estimate_capability ~73
HTTP alias of hydracept_quote_capability. Same 0.3 retail quote (pricing.quote). 'input' is an alias for 'body'.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
| capability | string | – | – |
| capabilityKey | string | – | – |
| capability_key | string | – | – |
| input | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_capability_request_quote ~40
Read the human-paid commission quote for a capability request. This quoteId is never an execution.quoteId.
| Name | Type | Req | Description |
|---|---|---|---|
| request_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_capabilities ~65
List, find, or describe capabilities. Includes one-shot readiness facts. Text job_async descriptors may include features.deferredProcessing (50% off standard token rates). Works before workspace init (anonymous discovery).
| Name | Type | Req | Description |
|---|---|---|---|
| key | string | – | – |
| query | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_download_artifact ~72
Download an artifact into the workspace; out/output_path select the destination.
| Name | Type | Req | Description |
|---|---|---|---|
| artifact_id | string | – | – |
| job_id | string | yes | – |
| label | string | – | – |
| out | string | – | – |
| outputPath | string | – | – |
| output_path | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_get_receipt ~63
Fetch a sealed receipt by job/execution id or by receiptId returned from a prior result.
| Name | Type | Req | Description |
|---|---|---|---|
| jobId | string | – | – |
| job_id | string | – | – |
| receiptId | string | – | – |
| receipt_id | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_interaction_surface ~46
Present one human-facing Hydracept interaction; never pass secrets in context.
| Name | Type | Req | Description |
|---|---|---|---|
| context | – | – | – |
| interactive | boolean | – | – |
| surface | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_invoke ~67
Invoke a synchronous capability (read-only domain/DNS and text). 'input' is an alias for 'body'.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
| capability | string | – | – |
| capabilityKey | string | – | – |
| capability_key | string | – | – |
| input | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_job_inspect ~38
Inspect one job's error, diagnostics, receipt summary, request snapshot, and reuse candidate.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_job_status ~52
GET /v1/jobs/{jobId} once. If nextAction is poll, wait pollAfterSeconds and call again.
| Name | Type | Req | Description |
|---|---|---|---|
| jobId | string | – | – |
| job_id | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_jobs_find ~51
Find recent, failed, or reusable jobs in this checkout without asking for a job id.
| Name | Type | Req | Description |
|---|---|---|---|
| capability_key | string | – | – |
| intent | string | – | – |
| limit | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_lockfile_emit ~43
GET /v1/provenance/lockfile?receipt_id= — AI lockfile from a pinned receipt.
| Name | Type | Req | Description |
|---|---|---|---|
| receipt_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_manifest_create ~36
POST /v1/provenance/manifests — hash related pinned receipts into a run manifest.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_manifest_verify ~35
POST /v1/provenance/manifests/{manifest_id}/verify.
| Name | Type | Req | Description |
|---|---|---|---|
| manifest_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_pinned_bulk ~37
POST /v1/inference/pinned/bulk — concurrent pinned items, one logical execution each.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_pinned_bulk_get ~51
GET /v1/inference/pinned/bulk/{bulk_id} once. If nextAction is poll, wait pollAfterSeconds and call again.
| Name | Type | Req | Description |
|---|---|---|---|
| bulk_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_pinned_get ~32
GET /v1/inference/pinned/{receipt_id}.
| Name | Type | Req | Description |
|---|---|---|---|
| receipt_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_pinned_run ~81
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.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_project_get_operation ~36
GET a project operation by id. Poll until reported when a watcher is running.
| Name | Type | Req | Description |
|---|---|---|---|
| operation_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_project_request_operation ~51
Request an allowlisted project operation; watcher or watch_once executes it.
| Name | Type | Req | Description |
|---|---|---|---|
| action_key | string | – | – |
| command | string | yes | – |
| context | – | – | – |
| input | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_project_status ~29
Login-persistent project up status. Stdio only; cwd must be the game repo.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_project_sync ~29
Sync the operations allowlist from tools/hydracept/manifest.json. Wholesale replace.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_project_up_install ~27
Same as project up --install; credentials come from workspace, not arguments.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_project_watch_once ~25
Execute requested operations once unless login-persistent project up is running.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_quote_capability ~77
POST /v1/capabilities/{key}/quote — optional preview; does not reserve or charge funds. 'input' is an alias for 'body'.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
| capability | string | – | – |
| capabilityKey | string | – | – |
| capability_key | string | – | – |
| input | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_run ~107
Canonical run. Waits for terminal completion by default; pass wait=false for a continuation. 'input' is an alias for 'body'.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
| capability | string | – | – |
| capabilityKey | string | – | – |
| capability_key | string | – | – |
| idempotency_key | string | – | – |
| input | – | – | – |
| max_cost | – | – | – |
| out | string | – | – |
| timeout | – | – | – |
| wait | boolean | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_smoke ~69
Explicit managed-trial smoke. Downloads first artifact when available.
| Name | Type | Req | Description |
|---|---|---|---|
| capability | string | – | – |
| capabilityKey | string | – | – |
| capability_key | string | – | – |
| output_path | string | – | – |
| poll_seconds | integer | – | – |
| prompt | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_status ~29
Local workspace readiness. Set refresh=true for optional network verify.
| Name | Type | Req | Description |
|---|---|---|---|
| refresh | boolean | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_submit_job ~101
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
| capability | string | – | – |
| capabilityKey | string | – | – |
| capability_key | string | – | – |
| idempotency_key | string | – | – |
| input | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_surface_apply ~34
Apply one surface JSON or all project surfaces. Does not grant the allowlist.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_approve_job ~45
Exact POST /v1/jobs/{id}/approve. For awaiting_approval human gates only.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
| job_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_artifact_preview ~63
App-only bounded media preview. Server uses the workspace client; iframe has no API token.
| Name | Type | Req | Description |
|---|---|---|---|
| artifactId | string | – | – |
| artifact_id | string | – | – |
| jobId | string | – | – |
| job_id | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_cancel_job ~31
Explicit job cancel. Stop watching must not call this.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_connect_project ~47
App-only init adapter. Canonical init owns binding writes.
| Name | Type | Req | Description |
|---|---|---|---|
| displayName | string | – | – |
| environment | string | – | – |
| project_name | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_connection_recheck ~33
Re-read authoritative connection/runnability. Never accepts secrets.
| Name | Type | Req | Description |
|---|---|---|---|
| capability_key | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_download_artifact ~70
Panel workspace save. Iframe has no API token; server uses the workspace client.
| Name | Type | Req | Description |
|---|---|---|---|
| artifactId | string | – | – |
| artifact_id | string | – | – |
| jobId | string | – | – |
| job_id | string | – | – |
| output_path | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_poll_job ~39
Panel job poll. Same projection as hydracept_job_status; proves the App is mounted.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_promote ~32
Project-local apply_surfaces(path). Cloud never writes the repository.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_quote ~39
App-only quote adapter. Same primitive as hydracept_quote_capability.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
| capability_key | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_reject_job ~32
Exact POST /v1/jobs/{id}/reject.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_run ~58
App-only run adapter. Uses the existing run façade (invoke vs jobs from executionModes).
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
| capability_key | string | yes | – |
| idempotency_key | string | – | – |
| max_cost | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_select_variant ~40
Exact POST /v1/jobs/{id}/variants/select.
| Name | Type | Req | Description |
|---|---|---|---|
| artifact_id | string | yes | – |
| job_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_ui_submit_job ~56
Panel submit. Same execution as hydracept_submit_job; no App remount (no resourceUri).
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
| capability_key | string | – | – |
| idempotency_key | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
hydracept_verify_lockfile ~47
POST /v1/provenance/lockfile/verify. Prefer `python -m hydracept verify` for local hydracept.lock.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
request_capability_quote ~40
Create a non-binding capability implementation request. Humans must accept commission quotes. Do not pass commission quoteId as execution.quoteId.
| Name | Type | Req | Description |
|---|---|---|---|
| body | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
resolve_capability ~37
Determine whether Hydracept already provides a suitable capability. Does not spend money.
| Name | Type | Req | Description |
|---|---|---|---|
| intent | string | yes | – |
| requirements | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
What is the Hydracept MCP server?
Hydracept is an MCP server listed in the public MCP registry as com.hydracept/hydracept. Execution control plane for agents: capabilities, durable jobs, budgets, receipts, and BYOK. This page covers its PyPI package (hydracept).
Is the Hydracept MCP server safe to use?
Hydracept scores 53 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 29 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Hydracept MCP server expose?
Hydracept exposes 45 tools: hydracept_status, hydracept_capabilities, resolve_capability, estimate_capability, hydracept_quote_capability, and 40 more. Their descriptions and schemas cost roughly 2,205 tokens of context every time the server is loaded.
Is the Hydracept MCP server still maintained?
Hydracept is still listed as active in the MCP registry. We last reached this channel on 29 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Hydracept MCP server under?
Hydracept declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.