hydracept MCP server — tools & history
hydracept MCP server: observed open status, tool schemas, linked apps and version history.
hydracept
Endpoint: https://api.hydracept.com/mcp
Observed status: open. Checked: 2026-10-13T05:09:09+00:00.
Linked apps
- hydracept
Execution infrastructure for AI agents. Run text, reasoning, image, audio, video, 3D, domains, DNS, and more through one capability API—with durable jobs, transparent pricing, receipts, budgets, and BYOK.
Observed tools
- get_capability_request_quote — GET /v1/capability-requests/{id}/quote: read commission quote for an existing request. Use after request_capability_quote; not for retail hydracept_quote_capability. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_bind_adapter_alias — POST recipe binding for alias version. Auth: bearer required. Side effects: persists binding.
- hydracept_capabilities — GET /v1/capabilities (list or ?view=summary) or POST /v1/capabilities/resolve when query is set without key. Use for catalog facts and descriptor fields; use resolve_capability for intent-only routing. Auth: none for list/resolve; bearer optional for enriched access fields. Cost: none. Side effects: none.
- hydracept_clear_adapter_default — DELETE/clear project adapter default override. Auth: bearer required. Side effects: mutates default.
- hydracept_create_adapter_alias — POST /v1/adapter-aliases: create semantic alias pointing at adapter/weight. Auth: bearer required. Side effects: mutates alias map.
- hydracept_download_artifact — GET /v1/jobs/{jobId}/artifacts/{artifactId} (stream). Hosted MCP returns metadata and SHA-256 only; stdio may write bytes when output_path is set. Use after a succeeded job lists artifacts. Auth: bearer required. Cost: none. Side effects: none on hosted; stdio may write a file.
- hydracept_get_receipt — READ-ONLY: GET /v1/jobs/{jobId}/receipt for an already-completed job. Does NOT run capabilities, create jobs, or spend money. Use when the user asks for billing/provenance on a finished job; use hydracept_job_status for in-flight state. Hosted MCP accepts job_id only. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_invoke — POST /v1/capabilities/{key}/invoke: synchronous capability call (no job poll loop). Use only when the capability descriptor lists invoke_sync; use hydracept_run for job-based execution and hydracept_pinned_run for exact model pins. Auth: bearer required. Cost: billed like invoke admission. Side effects: may create invoke audit records.
- hydracept_job_inspect — Read one prior job, including the prompt that was executed. executedPrompt is that prompt, also stored at requestSnapshot.input.prompt. Text jobs return it when a prompt record was kept and no input payload was stored. Also returns error, diagnostics, receipt summary, and a reuse candidate. Pass job_id from hydracept_jobs_find or an earlier run. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_job_status — GET /v1/jobs/{jobId} once. Use to poll after hydracept_submit_job or hydracept_run with wait=false; use hydracept_get_receipt for sealed billing/provenance after terminal success. hydracept_job_inspect and hydracept_jobs_find are on the full profile. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_jobs_find — Find a prior job in the workspace-bound project when you do not have its id. intent is recent, failed, or reusable. This list never includes prompt text. To read the prompt that was executed, call hydracept_job_inspect and read executedPrompt (requestSnapshot.input.prompt). Bind the project that owns the job before searching. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_lockfile_emit — GET /v1/provenance/lockfile?receipt_id=: emit lockfile JSON for a pinned inference receipt. Use after hydracept_pinned_run / hydracept_pinned_get; verify with hydracept_verify_lockfile. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_manifest_create — POST /v1/provenance/manifests: hash pinned inference receipts into a manifest id. Use after hydracept_pinned_run; capability job receipts are not accepted. Verify with hydracept_manifest_verify. Auth: bearer required. Cost: none. Side effects: creates manifest record.
- hydracept_manifest_verify — POST /v1/provenance/manifests/{manifest_id}/verify: check manifest members. Read-only verification. Use after hydracept_manifest_create. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_model_adapters — GET adapter catalog: registered LoRAs, aliases, defaults, routing readiness for the bound project. Use before hydracept_use_lora or adapter mutation tools. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_pinned_bulk — POST /v1/inference/pinned/bulk: concurrent pinned items (one execution each). Use for batch pins; use hydracept_pinned_run for a single pin. Auth: bearer required. Cost: billed per item. Side effects: creates bulk run state.
- hydracept_pinned_bulk_get — GET /v1/inference/pinned/bulk/{bulk_id}: poll bulk pinned run aggregate. Use when hydracept_pinned_bulk returns nextAction poll. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_pinned_get — GET /v1/inference/pinned/{receipt_id}: fetch pinned run receipt. Use after hydracept_pinned_run; use hydracept_get_receipt for capability jobs. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_pinned_run — POST /v1/inference/pinned: one exact provider/model pin with scientific receipt. Use for pinned inference experiments; use hydracept_run for registry capability keys. Optional processing=deferred for 50% Flex pricing when supported; no Flex→Standard fallback; capacity 429s may retry inside the admission deadline. Auth: bearer required. Cost: paid — hold at worst-case then settle at actual cost. Side effects: creates pinned receipt.
- hydracept_prepare_adapter_selection — Build generation patch from selected adapters list. Read-only composition helper. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_preview_lora_source — Preview Hugging Face or registry LoRA source before register. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_project_get_operation — GET /v1/projects/{projectId}/operations/{id}: poll operation status. Use after hydracept_project_request_operation. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_project_request_operation — POST /v1/projects/{projectId}/operations: enqueue allowlisted project operation for local execution. Hosted MCP does not run argv; stdio watch_once/up executes. Auth: bearer required. Side effects: creates operation record.
- hydracept_promote_adapter_alias — POST /v1/adapter-aliases/{alias}/promotions: new immutable alias version. Auth: bearer required. Side effects: mutates alias history.
- hydracept_quote_capability — POST /v1/capabilities/{key}/quote: price preview only — does NOT run the capability, does NOT create a job, and does NOT charge or hold wallet funds. Use when the user asks how much something would cost or wants an estimate before deciding to execute; use hydracept_run or hydracept_submit_job only if they explicitly want execution. Not the same as request_capability_quote (full profile; commission / human-paid). Auth: bearer API key required. Cost: none. Side effects: none.
- hydracept_register_model_adapter — POST /v1/model-adapters: register LoRA source for the project. Auth: bearer required. Cost: none. Side effects: mutates project adapter registry.
- hydracept_revalidate_model_adapter — POST revalidate adapter source metadata. Auth: bearer required. Side effects: updates adapter record.
- hydracept_run — EXECUTE a capability now (paid). Use only when the user wants the capability to run — not for price checks (hydracept_quote_capability), status (hydracept_job_status), or receipts (hydracept_get_receipt). Default wait=true blocks until terminal; use hydracept_submit_job when execution is required but this call must not block. Hosted POST .../jobs when the descriptor supports jobs; invoke-only descriptors use POST .../invoke. Auth: bearer required. Cost: paid — admission reserves a hold at the primary model's worst-case price (capped by max_cost or account ceiling); charge settles at actual cost with no per-call minimum. Side effects: executes the capability (may be irreversible); creates job/artifact records when applicable.
- hydracept_set_adapter_default — POST project default alias for image.generate.v1 route. Auth: bearer required. Side effects: mutates default.
- hydracept_smoke — Runs one REAL paid image.generate.v1 job (trial credit if eligible, otherwise wallet-billed like hydracept_run) — not a dry run or quote. Use only when the user explicitly wants a managed-trial smoke execution; never for price checks (hydracept_quote_capability) or catalog questions. Auth: bearer required. Cost: paid image generation. Side effects: creates job/receipt and provider usage.
- hydracept_status — READ-ONLY session/workspace diagnostics — does NOT execute capabilities or spend money. Hosted: GET /v1/diagnostics/session with bearer (WORKSPACE_KEY_REQUIRED when missing). Stdio: local workspace readiness without a key. Use when auth or project binding errors appear; not a substitute for hydracept_capabilities. Cost: none. Side effects: none.
- hydracept_submit_job — EXECUTE via POST /v1/capabilities/{key}/jobs and return immediately with a job id (paid). Use when execution is required but this MCP call must not block — not for quotes, receipts, or status. Do NOT use for 'how much would X cost?' (hydracept_quote_capability) or checking an existing job (hydracept_job_status / hydracept_get_receipt). Prefer hydracept_run when wait=true is acceptable. Poll with hydracept_job_status. Auth: bearer required. Cost: same hold/settle as hydracept_run. Side effects: executes the capability; creates a job record.
- hydracept_suggest_lora — Suggest project alias or registered LoRA from query string. Auth: bearer required. Cost: none. Side effects: none.
- hydracept_use_lora — Resolve query to adapter selection for image.generate.v1. Auth: bearer required. Cost: none. Side effects: none (selection only).
- hydracept_verify_lockfile — POST /v1/provenance/lockfile/verify: validate lockfile document. Use after hydracept_lockfile_emit or for CI replay. Auth: bearer required. Cost: none. Side effects: none.
- request_capability_quote — POST /v1/capability-requests then submit: human-paid commission quote for a missing capability. Not retail execution pricing (see hydracept_quote_capability). quoteId from this flow must not be used as execution.quoteId on jobs. Auth: bearer required. Cost: none to the agent (humans pay commission). Side effects: creates request rows.
- resolve_capability — POST /v1/capabilities/resolve: rank capabilities from natural-language intent. Use when the capability key is unknown; use hydracept_capabilities when you already have a key or need the catalog list/search. Auth: none (keyless). Cost: none. Side effects: none.
Data as of 2026-10-13T05:09:09+00:00.
OpenApps records store listings and observed changes. Store ranks are not download counts; launch dates may be derived or use the first observation. Coverage gaps are shown in the interactive catalog.
REST API specification · Guide for AI clients · Manage API keys and MCP connections