Hydracept
Execution control plane for agents: capabilities, durable jobs, budgets, receipts, and BYOK.
Should I use this
Quality & Safety
Findings (12)
- LOWTool 'hydracept_status' description lacks action verbin hydracept_status
- LOWTool 'hydracept_quote_capability' description lacks action verbin hydracept_quote_capability
- LOWTool 'estimate_capability' description lacks action verbin estimate_capability
- LOWTool 'hydracept_manifest_create' description lacks action verbin hydracept_manifest_create
- LOWTool 'hydracept_clear_adapter_default' description lacks action verbin hydracept_clear_adapter_default
- LOWTool 'hydracept_project_request_operation' name length outside 3-30 rangein hydracept_project_request_operation
- LOWTool 'hydracept_project_get_operation' name length outside 3-30 rangein hydracept_project_get_operation
- LOWTool 'hydracept_prepare_adapter_selection' name length outside 3-30 rangein hydracept_prepare_adapter_selection
- LOWTool 'hydracept_promote_adapter_alias' name length outside 3-30 rangein hydracept_promote_adapter_alias
- LOWTool 'hydracept_clear_adapter_default' name length outside 3-30 rangein hydracept_clear_adapter_default
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"hydracept": {
"command": "uvx",
"args": [
"hydracept"
]
}
}
}Runnable packages
0.4.4stdioRemote endpoints
https://api.hydracept.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (38)
⚪hydracept_status(refresh)
Session diagnostics for the authenticated API key.
Input Schema
{
"type": "object",
"properties": {
"refresh": {
"default": false,
"title": "Refresh",
"type": "boolean"
}
},
"title": "hydracept_statusArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_statusDictOutput"
}🟢hydracept_capabilities(key, query)
List, find, or describe capabilities. Includes one-shot readiness facts. Text job_async descriptors may include features.deferredProcessing (50% off standard token rates).
Input Schema
{
"type": "object",
"properties": {
"key": {
"default": "",
"title": "Key",
"type": "string"
},
"query": {
"default": "",
"title": "Query",
"type": "string"
}
},
"title": "hydracept_capabilitiesArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_capabilitiesDictOutput"
}⚪resolve_capability(intent, requirements)
Determine whether Hydracept already provides a suitable capability. Does not spend money.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "resolve_capabilityDictOutput"
}🟡hydracept_quote_capability(capability_key, body, input)
POST /v1/capabilities/{key}/quote. Does not reserve or charge funds. 'input' is an alias for 'body'.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_quote_capabilityDictOutput"
}⚪estimate_capability(capability_key, body, input)
HTTP alias of hydracept_quote_capability. Same 0.3 retail quote. 'input' is an alias for 'body'.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "estimate_capabilityDictOutput"
}⚪hydracept_invoke(capability_key, body, input)
Invoke a synchronous capability (read-only domain/DNS and text). 'input' is an alias for 'body'.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_invokeDictOutput"
}⚪hydracept_run(capability_key, body, wait, timeout, max_cost, ...)
hydracept.run-result.v1 over hosted HTTP. Artifact persist requires stdio MCP in a checkout. 'input' is an alias for 'body'.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_runDictOutput"
}🟡request_capability_quote(body)
Create a capability REQUEST. Commission quotes are human-paid and must not be used as execution.quoteId.
Input Schema
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "request_capability_quoteArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "request_capability_quoteDictOutput"
}🟢get_capability_request_quote(request_id)
Read the human-paid commission quote for a capability request. Never an execution.quoteId.
Input Schema
{
"type": "object",
"properties": {
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"request_id"
],
"title": "get_capability_request_quoteArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "get_capability_request_quoteDictOutput"
}🟡hydracept_submit_job(capability_key, body, idempotency_key, input)
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'.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_submit_jobDictOutput"
}🟢hydracept_job_status(job_id)
GET /v1/jobs/{jobId} once. If nextAction is poll, wait pollAfterSeconds and call again.
Input Schema
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_job_statusArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_job_statusDictOutput"
}🟢hydracept_get_receipt(job_id)
Fetch sealed receipt summary for a job.
Input Schema
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_get_receiptArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_get_receiptDictOutput"
}🟡hydracept_download_artifact(job_id, artifact_id)
Return artifact download metadata and content hash (hosted MCP does not write local files).
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_download_artifactDictOutput"
}⚪hydracept_smoke(capability, prompt, poll_seconds, output_path)
Explicit managed-trial smoke. Same contract as stdio: generation, pricing, SHA-256, PNG alpha.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_smokeDictOutput"
}🟡hydracept_pinned_run(body)
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.
Input Schema
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_pinned_runArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_runDictOutput"
}🟡hydracept_pinned_bulk(body)
POST /v1/inference/pinned/bulk — concurrent pinned items, one logical execution each.
Input Schema
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_pinned_bulkArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_bulkDictOutput"
}🟢hydracept_pinned_get(receipt_id)
GET /v1/inference/pinned/{receipt_id}.
Input Schema
{
"type": "object",
"properties": {
"receipt_id": {
"title": "Receipt Id",
"type": "string"
}
},
"required": [
"receipt_id"
],
"title": "hydracept_pinned_getArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_getDictOutput"
}🟢hydracept_pinned_bulk_get(bulk_id)
GET /v1/inference/pinned/bulk/{bulk_id} once. If nextAction is poll, wait pollAfterSeconds and call again.
Input Schema
{
"type": "object",
"properties": {
"bulk_id": {
"title": "Bulk Id",
"type": "string"
}
},
"required": [
"bulk_id"
],
"title": "hydracept_pinned_bulk_getArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_bulk_getDictOutput"
}🟡hydracept_manifest_create(body)
POST /v1/provenance/manifests.
Input Schema
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_manifest_createArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_manifest_createDictOutput"
}🟡hydracept_manifest_verify(manifest_id)
POST /v1/provenance/manifests/{manifest_id}/verify.
Input Schema
{
"type": "object",
"properties": {
"manifest_id": {
"title": "Manifest Id",
"type": "string"
}
},
"required": [
"manifest_id"
],
"title": "hydracept_manifest_verifyArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_manifest_verifyDictOutput"
}🟢hydracept_lockfile_emit(receipt_id)
GET /v1/provenance/lockfile?receipt_id=.
Input Schema
{
"type": "object",
"properties": {
"receipt_id": {
"title": "Receipt Id",
"type": "string"
}
},
"required": [
"receipt_id"
],
"title": "hydracept_lockfile_emitArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_lockfile_emitDictOutput"
}🟡hydracept_verify_lockfile(body)
POST /v1/provenance/lockfile/verify.
Input Schema
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_verify_lockfileArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_verify_lockfileDictOutput"
}🟢hydracept_jobs_find(intent, capability_key, limit, project_id)
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.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_jobs_findDictOutput"
}🟢hydracept_job_inspect(job_id)
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.
Input Schema
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_job_inspectArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_job_inspectDictOutput"
}🟡hydracept_project_request_operation(command, action_key, project_id, input, context)
POST a project operation. Hosted MCP does not run the customer repo; a local watcher must execute it.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_project_request_operationDictOutput"
}🟢hydracept_project_get_operation(operation_id, project_id)
Poll a project operation. Execution happens in the game checkout, not on this host.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_project_get_operationDictOutput"
}🟢hydracept_model_adapters(project_id, environment)
List the bound project's registered model adapters, semantic aliases, image-generation default, and static routing readiness. To use one LoRA, call hydracept_use_lora with its alias or name. To suggest a new public LoRA, call hydracept_suggest_lora with a Hugging Face link. Do not assemble adapter ids, weight filenames, or base-model families. 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. The project default is not applied unless the caller sends input.adapters. Trigger words are stored and are not added to the prompt.
Input Schema
{
"type": "object",
"properties": {
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"title": "hydracept_model_adaptersArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_model_adaptersDictOutput"
}🟡hydracept_prepare_adapter_selection(adapters)
Normalize several LoRA selections into the exact image.generate.v1 input.adapters contract. For one named LoRA, call hydracept_use_lora instead. This does not submit or spend money. Select only route-compatible entries.
Input Schema
{
"type": "object",
"properties": {
"adapters": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Adapters"
}
},
"title": "hydracept_prepare_adapter_selectionArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_prepare_adapter_selectionDictOutput"
}🟡hydracept_create_adapter_alias(alias, adapter_id, weight, project_id, environment)
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.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_create_adapter_aliasDictOutput"
}⚪hydracept_promote_adapter_alias(alias, adapter_id, weight, project_id, environment)
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.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_promote_adapter_aliasDictOutput"
}⚪hydracept_bind_adapter_alias(alias, version_id, project_id, environment)
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.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_bind_adapter_aliasDictOutput"
}🟡hydracept_set_adapter_default(alias, capability_key, project_id, environment)
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.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_set_adapter_defaultDictOutput"
}🔴hydracept_clear_adapter_default(capability_key, project_id, environment)
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.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_clear_adapter_defaultDictOutput"
}🟢hydracept_suggest_lora(query, project_id, environment)
Suggest a LoRA without registering it or spending money. query can be a project alias, a registered LoRA name, an adapter id, or a public Hugging Face link. Show the user the say field. If intent is use, pass inputPatch.adapters on image.generate.v1. If intent is suggest, wait for the user to agree, then call hydracept_use_lora with accept.arguments. If intent is choose, ask the question in say, then call hydracept_use_lora with file_path or base_model_family. Do not invent repository paths, commits, weight filenames, or base-model families.
Input Schema
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"query"
],
"title": "hydracept_suggest_loraArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_suggest_loraDictOutput"
}🟡hydracept_use_lora(query, file_path, base_model_family, refresh, project_id, ...)
Use one LoRA on image generation, or add an unambiguous public Hugging Face LoRA and then use it. Does not generate an image or spend money. Pass a project alias, registered name, adapter id, or the same query hydracept_suggest_lora returned. Pass file_path only after a suggestion says to choose a weights file. Pass base_model_family only after a suggestion says the base model is missing. Pass refresh=true only when the suggestion says a newer commit is available. When inputPatch is present, pass inputPatch.adapters on image.generate.v1. Do not fill adapter ids, file paths, or base-model families yourself.
Input Schema
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"file_path": {
"default": "",
"title": "File Path",
"type": "string"
},
"base_model_family": {
"default": "",
"title": "Base Model Family",
"type": "string"
},
"refresh": {
"default": false,
"title": "Refresh",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"query"
],
"title": "hydracept_use_loraArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_use_loraDictOutput"
}🟢hydracept_register_model_adapter(display_name, source_kind, source_ref, base_model_family, source_revision, ...)
Register a reusable project LoRA without generating or spending money. Prefer hydracept_suggest_lora and hydracept_use_lora for a project name or a public Hugging Face link. Use this tool for provider_ref or hydracept_artifact sources, or when the caller already has every source field. source_kind must be provider_ref, huggingface, or hydracept_artifact. 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.
Input 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"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_register_model_adapterDictOutput"
}🟡hydracept_preview_lora_source(query, project_id, environment)
Low-level lookup for a public Hugging Face LoRA link. Prefer hydracept_suggest_lora, which also matches project aliases and returns a generation patch or a confirmation. Returns the pinned commit, weight files, detected base-model family, suggested name, strength, and trigger words. Does not register an adapter, download weight tensors, or spend money. A detected family with executable=false can be saved but current image routes cannot run it.
Input Schema
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"query"
],
"title": "hydracept_preview_lora_sourceArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_preview_lora_sourceDictOutput"
}🟢hydracept_revalidate_model_adapter(adapter_id)
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.
Input Schema
{
"type": "object",
"properties": {
"adapter_id": {
"title": "Adapter Id",
"type": "string"
}
},
"required": [
"adapter_id"
],
"title": "hydracept_revalidate_model_adapterArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_revalidate_model_adapterDictOutput"
}Community
Evidence