HydraCore
API by router

Mcp credentials admin

List Mcp Credentials

List MCP credentials for an instance (metadata only, no plaintext).

Returns the server slugs and env var KEY NAMES — never the values. This is safe for the dashboard to display.

"What we've got here is failure to communicate." — Captain, Cool Hand Luke (about listing credentials without revealing them)

GET
/v1/instances/{instance_id}/mcp-credentials
AuthorizationBearer <token>

In: header

Path Parameters

instance_idInstance Id
Formatuuid

Header Parameters

X-Api-Key?X-Api-Key

Response Body

curl -X GET "https://loading/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/mcp-credentials" \  -H "X-Api-Key: string"
{
  "credentials": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "env_var_names": [
        "string"
      ],
      "server_slug": "string",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "instance_id": "06587974-2dbe-4e10-8bf9-38cce0f5a366"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Delete Mcp Credentials

Remove MCP server credentials for an instance.

"Forget it, Jake. It's Chinatown." — Walsh, Chinatown (about credentials that no longer exist)

DELETE
/v1/instances/{instance_id}/mcp-credentials/{server_slug}
AuthorizationBearer <token>

In: header

Path Parameters

instance_idInstance Id
Formatuuid
server_slugServer Slug

Header Parameters

X-Api-Key?X-Api-Key

Response Body

curl -X DELETE "https://loading/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/mcp-credentials/string" \  -H "X-Api-Key: string"
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Set Mcp Credentials

Set or update MCP server credentials for an instance.

Upserts the credential row — if credentials already exist for this (instance_id, server_slug) pair, they are overwritten.

"Every time I try to get out, they pull me back in!" — Michael Corleone (about updating MCP credentials)

PUT
/v1/instances/{instance_id}/mcp-credentials/{server_slug}
AuthorizationBearer <token>

In: header

Path Parameters

instance_idInstance Id
Formatuuid
server_slugServer Slug

Header Parameters

X-Api-Key?X-Api-Key
credentialsCredentials

Dict of env vars to inject, e.g. {'XERO_CLIENT_ID': '...', 'XERO_CLIENT_SECRET': '...'}

Properties1 <= properties

Empty Object

Response Body

curl -X PUT "https://loading/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/mcp-credentials/string" \  -H "X-Api-Key: string" \  -H "Content-Type: application/json" \  -d '{    "credentials": {}  }'
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}