Hydracept
Execution control plane for agents: capabilities, durable jobs, budgets, receipts, and BYOK.
使うべきか
品質と安全性
検出事項（12）
- LOWTool 'hydracept_status' description lacks action verbhydracept_status 内
- LOWTool 'hydracept_quote_capability' description lacks action verbhydracept_quote_capability 内
- LOWTool 'estimate_capability' description lacks action verbestimate_capability 内
- LOWTool 'hydracept_manifest_create' description lacks action verbhydracept_manifest_create 内
- LOWTool 'hydracept_clear_adapter_default' description lacks action verbhydracept_clear_adapter_default 内
- LOWTool 'hydracept_project_request_operation' name length outside 3-30 rangehydracept_project_request_operation 内
- LOWTool 'hydracept_project_get_operation' name length outside 3-30 rangehydracept_project_get_operation 内
- LOWTool 'hydracept_prepare_adapter_selection' name length outside 3-30 rangehydracept_prepare_adapter_selection 内
- LOWTool 'hydracept_promote_adapter_alias' name length outside 3-30 rangehydracept_promote_adapter_alias 内
- LOWTool 'hydracept_clear_adapter_default' name length outside 3-30 rangehydracept_clear_adapter_default 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"hydracept": {
"command": "uvx",
"args": [
"hydracept"
]
}
}
}実行可能なパッケージ
0.4.4stdioリモートエンドポイント
https://api.hydracept.com/mcpstreamable-httpできること
ツール一覧
ツール（38）
⚪hydracept_status(refresh)
Session diagnostics for the authenticated API key.
入力スキーマ
{
"type": "object",
"properties": {
"refresh": {
"default": false,
"title": "Refresh",
"type": "boolean"
}
},
"title": "hydracept_statusArguments"
}出力スキーマ
{
"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).
入力スキーマ
{
"type": "object",
"properties": {
"key": {
"default": "",
"title": "Key",
"type": "string"
},
"query": {
"default": "",
"title": "Query",
"type": "string"
}
},
"title": "hydracept_capabilitiesArguments"
}出力スキーマ
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_capabilitiesDictOutput"
}⚪resolve_capability(intent, requirements)
Determine whether Hydracept already provides a suitable capability. Does not spend money.
入力スキーマ
{
"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"
}出力スキーマ
{
"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'.
入力スキーマ
{
"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"
}出力スキーマ
{
"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'.
入力スキーマ
{
"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"
}出力スキーマ
{
"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'.
入力スキーマ
{
"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"
}出力スキーマ
{
"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'.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "request_capability_quoteArguments"
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"request_id"
],
"title": "get_capability_request_quoteArguments"
}出力スキーマ
{
"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'.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_job_statusArguments"
}出力スキーマ
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_job_statusDictOutput"
}🟢hydracept_get_receipt(job_id)
Fetch sealed receipt summary for a job.
入力スキーマ
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_get_receiptArguments"
}出力スキーマ
{
"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).
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_pinned_runArguments"
}出力スキーマ
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_runDictOutput"
}🟡hydracept_pinned_bulk(body)
POST /v1/inference/pinned/bulk — concurrent pinned items, one logical execution each.
入力スキーマ
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_pinned_bulkArguments"
}出力スキーマ
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_bulkDictOutput"
}🟢hydracept_pinned_get(receipt_id)
GET /v1/inference/pinned/{receipt_id}.
入力スキーマ
{
"type": "object",
"properties": {
"receipt_id": {
"title": "Receipt Id",
"type": "string"
}
},
"required": [
"receipt_id"
],
"title": "hydracept_pinned_getArguments"
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"bulk_id": {
"title": "Bulk Id",
"type": "string"
}
},
"required": [
"bulk_id"
],
"title": "hydracept_pinned_bulk_getArguments"
}出力スキーマ
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_bulk_getDictOutput"
}🟡hydracept_manifest_create(body)
POST /v1/provenance/manifests.
入力スキーマ
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_manifest_createArguments"
}出力スキーマ
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_manifest_createDictOutput"
}🟡hydracept_manifest_verify(manifest_id)
POST /v1/provenance/manifests/{manifest_id}/verify.
入力スキーマ
{
"type": "object",
"properties": {
"manifest_id": {
"title": "Manifest Id",
"type": "string"
}
},
"required": [
"manifest_id"
],
"title": "hydracept_manifest_verifyArguments"
}出力スキーマ
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_manifest_verifyDictOutput"
}🟢hydracept_lockfile_emit(receipt_id)
GET /v1/provenance/lockfile?receipt_id=.
入力スキーマ
{
"type": "object",
"properties": {
"receipt_id": {
"title": "Receipt Id",
"type": "string"
}
},
"required": [
"receipt_id"
],
"title": "hydracept_lockfile_emitArguments"
}出力スキーマ
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_lockfile_emitDictOutput"
}🟡hydracept_verify_lockfile(body)
POST /v1/provenance/lockfile/verify.
入力スキーマ
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_verify_lockfileArguments"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_job_inspectArguments"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"title": "hydracept_model_adaptersArguments"
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"adapters": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Adapters"
}
},
"title": "hydracept_prepare_adapter_selectionArguments"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"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"
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"adapter_id": {
"title": "Adapter Id",
"type": "string"
}
},
"required": [
"adapter_id"
],
"title": "hydracept_revalidate_model_adapterArguments"
}出力スキーマ
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_revalidate_model_adapterDictOutput"
}コミュニティ
エビデンス