Skip to main content

hydracept

Python client for the Hydracept public API — an execution control plane for software and agents that need external capabilities.

Official MCP Registry name matches hydracept-plugin mcp-registry/server.json (com.hydracept/hydracept, domain-verified on hydracept.com). Cursor plugin distribution: github.com/zencodeinc/hydracept-plugin (v0.1.10).

pip install hydracept

Python SDK

from hydracept import HydraceptClient

client = HydraceptClient(token=None)  # keyless discovery works without Authorization
caps = client.capabilities()
print(len(caps["capabilities"]))

Required onboarding is python -m hydracept init --apply --yes --json. Init reuses an authenticated GitHub CLI (gh) session when one is already available; otherwise use a browser connect flow or HYDRACEPT_API_KEY. Canonical docs are https://docs.hydracept.com. hydracept run --input-file accepts structured JSON on Windows/PowerShell, including UTF-8 BOM and UTF-16 files. Funding status reports customer-visible managed credit separately from trial and operator execution funding. Receipts distinguish retail price from the amount the customer actually owes or was debited (pricing.customerCharge). Domain and CPU capabilities omit inference billingModes.

python -m hydracept init --apply --yes --json
python -m hydracept doctor
python -m hydracept verify
python -m hydracept pinned --help

Pinned Execution (RIP) and provenance:

python -m hydracept pinned run body.json
python -m hydracept pinned get <receipt_id>
python -m hydracept lockfile emit <receipt_id>
python -m hydracept verify

Developer onboarding

python -m hydracept init --apply --yes --json
python -m hydracept doctor
python -m hydracept agents install --auto
python -m hydracept smoke

Native integrations for Cursor, Claude Code, and Google Antigravity ship via the Agent Pack (agents install). Session hooks inject local readiness only — smoke is explicit.

MCP tool profiles

tools/list is fixed for the MCP process lifetime. Stdio defaults to full (all specialists). Set HYDRACEPT_MCP_TOOL_PROFILE=compact (or python -m hydracept mcp serve --tool-profile compact) for the nine first-time-agent tools. On the full profile (stdio default), tools/list includes legacy names such as resolve_capability, request_capability_quote, and get_capability_request_quote; matching hydracept_* names work on tools/call only. On compact, tools/list uses hydracept_* names only. Hosted POST https://api.hydracept.com/mcp and POST /mcp/full expose the full tools/list (unchanged for existing clients). POST https://api.hydracept.com/mcp/compact exposes the compact list (Glama opt-in). The Official MCP Registry remote is directory-safe OAuth at POST https://api.hydracept.com/mcp/claude (API keys rejected).

Agent / CI path (secret via env, not prompt)

export HYDRACEPT_API_KEY=hydracept_...
python -m hydracept quickstart --json --smoke
python -m hydracept consumer-check --strict

Breaking change in 0.2.3

hydracept login (device flow) stores a human session only. Mint a workspace API key with:

python -m hydracept keys create --configure

Docs: https://docs.hydracept.com · Start: https://hydracept.com/start

A Zencode company · © Zencode Consulting Inc.

Metadata

Release files for hydracept 0.5.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hydracept 0.5.6
File Size Uploaded Provenance Actions
hydracept-0.5.6.tar.gz 523.5 kB With provenance Details for hydracept-0.5.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hydracept 0.5.6
File Interpreter ABI Platform Actions
hydracept-0.5.6-py3-none-any.whl Python 3 none any Details for hydracept-0.5.6-py3-none-any.whl

Total release size: 1.0 MB

Release files / hydracept-0.5.6.tar.gz

Download URL hydracept-0.5.6.tar.gz
Size 523.5 kB
Tags Source
SHA-256 checksum
How to use checksums
f5dbdb20b5e692f117ccd80e8139a4e456535bb2c5770f6128b21ff6a5dd646e
BLAKE2b-256 checksum
How to use checksums
e98e3ac99dc4f389c8f11404512ccece818ed9a78594e0889aefebfacd8dece7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / hydracept-0.5.6-py3-none-any.whl

Download URL hydracept-0.5.6-py3-none-any.whl
Size 477.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
368162455ae5540cf2054bd97c8aba6ece37ef23e8e2c31960671fc880f743b4
BLAKE2b-256 checksum
How to use checksums
8b665076f7fcff62d280fa7a9dc639bcdd83cef76fe5dbc92abe31f939dca1c6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Security for hydracept 0.5.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for hydracept-0.5.6.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.5.6 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page