Hydracept

Reviewed 1d ago.

• tools: 37 tools scanned
• metadata: scanned
• packages: 1 checked

No findings.

Tools (37)

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

• 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_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_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_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_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_prepare_adapter_selection

  Build generation patch from selected adapters list. Read-only composition helper. Auth: bearer required. Cost: none. Side effects: none.

• hydracept_create_adapter_alias

  POST /v1/adapter-aliases: create semantic alias pointing at adapter/weight. Auth: bearer required. Side effects: mutates alias map.

• hydracept_promote_adapter_alias

  POST /v1/adapter-aliases/{alias}/promotions: new immutable alias version. Auth: bearer required. Side effects: mutates alias history.

• hydracept_bind_adapter_alias

  POST recipe binding for alias version. Auth: bearer required. Side effects: persists binding.

• hydracept_set_adapter_default

  POST project default alias for image.generate.v1 route. Auth: bearer required. Side effects: mutates default.

• hydracept_clear_adapter_default

  DELETE/clear project adapter default override. Auth: bearer required. Side effects: mutates default.

• 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_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_preview_lora_source

  Preview Hugging Face or registry LoRA source before register. Auth: bearer required. Cost: none. Side effects: none.

• hydracept_revalidate_model_adapter

  POST revalidate adapter source metadata. Auth: bearer required. Side effects: updates adapter record.

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

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

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