On this page

Agent registry gallery

GET/registry/agents

Operation getAgentRegistryAuthBearer token

Honours remoteCatalogsEnabled (off: bundled and cached only, no request).

Responses

StatusDescriptionBody
200OKAgentRegistryResult
agentsarray<object>
remoteErrorstring
Errors 401 · 403
401Missing or wrong bearer token (unauthorized)
403The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin

Error bodies use the error format.

Example

Request
curl "http://127.0.0.1:7385/registry/agents" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Re-fetch the agent registry index

POST/registry/agents/refresh

Operation refreshAgentRegistryAuthBearer token

Responses

StatusDescriptionBody
200OKAgentRegistryResult
agentsarray<object>
remoteErrorstring
Errors 401 · 403
401Missing or wrong bearer token (unauthorized)
403The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin

Error bodies use the error format.

Example

Request
curl -X POST "http://127.0.0.1:7385/registry/agents/refresh" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Copy a registry agent into the agents folder

POST/registry/agents/{id}/bring-home

Operation bringRegistryAgentHomeAuthBearer token

Identity stripped, fresh config.id, the app default provider when the model names none.

Path parameters

NameTypeDescription
idrequiredstring

Registry entry id

Responses

StatusDescriptionBody
200OKBringHomeResult
successrequiredboolean
filePathstring

The new file in the agents folder

errorstring
Errors 401 · 403
401Missing or wrong bearer token (unauthorized)
403The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin

Error bodies use the error format.

Example

Request
curl -X POST "http://127.0.0.1:7385/registry/agents/ID/bring-home" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Curated MCP registry

GET/registry/mcp

Operation getMcpRegistryAuthBearer token

Honours remoteCatalogsEnabled. A 24 h background refresh starts with the first call.

Responses

StatusDescriptionBody
200OKMcpRegistryResult
Errors 401 · 403
401Missing or wrong bearer token (unauthorized)
403The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin

Error bodies use the error format.

Example

Request
curl "http://127.0.0.1:7385/registry/mcp" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Fetch a skill catalog

GET/catalog/skills

Operation getSkillsCatalogAuthBearer token

https only, through the catalog guard (SSRF guard, redirect cap, size cap, 10 s).

Query parameters

NameTypeDescription
urlrequiredstring

Catalog URL (https)

Responses

StatusDescriptionBody
200OKSkillsCatalogResult
okrequiredboolean
entriesarray<object>
publisherany
droppedinteger
errorstring
Errors 401 · 403
401Missing or wrong bearer token (unauthorized)
403The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin

Error bodies use the error format.

Example

Request
curl "http://127.0.0.1:7385/catalog/skills?url=URL" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Fetch a SKILL.md package

GET/catalog/skills/package

Operation getSkillPackageAuthBearer token

Query parameters

NameTypeDescription
urlrequiredstring

SKILL.md URL (https)

Responses

StatusDescriptionBody
200OKSkillPackageResult
okrequiredboolean
contentstring

SKILL.md text

errorstring
Errors 401 · 403
401Missing or wrong bearer token (unauthorized)
403The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin

Error bodies use the error format.

Example

Request
curl "http://127.0.0.1:7385/catalog/skills/package?url=URL" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"