Registries
Agent registry, curated MCP registry and skill catalogs.
On this page
Agent registry gallery
GET
/registry/agentsHonours remoteCatalogsEnabled (off: bundled and cached only, no request).
Responses
| Status | Description | Body | ||||||
|---|---|---|---|---|---|---|---|---|
| 200 | OK | AgentRegistryResult | ||||||
| ||||||||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The 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
curl "http://127.0.0.1:7385/registry/agents" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Re-fetch the agent registry index
POST
/registry/agents/refreshResponses
| Status | Description | Body | ||||||
|---|---|---|---|---|---|---|---|---|
| 200 | OK | AgentRegistryResult | ||||||
| ||||||||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The 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
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-homeIdentity stripped, fresh config.id, the app default provider when the model names none.
Path parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Registry entry id |
Responses
| Status | Description | Body | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | BringHomeResult | |||||||||
| |||||||||||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The 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
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/mcpHonours remoteCatalogsEnabled. A 24 h background refresh starts with the first call.
Responses
| Status | Description | Body |
|---|---|---|
| 200 | OK | McpRegistryResult |
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The 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
curl "http://127.0.0.1:7385/registry/mcp" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Fetch a skill catalog
GET
/catalog/skillshttps only, through the catalog guard (SSRF guard, redirect cap, size cap, 10 s).
Query parameters
| Name | Type | Description |
|---|---|---|
urlrequired | string | Catalog URL (https) |
Responses
| Status | Description | Body | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | SkillsCatalogResult | |||||||||||||||
| |||||||||||||||||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The 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
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/packageQuery parameters
| Name | Type | Description |
|---|---|---|
urlrequired | string | SKILL.md URL (https) |
Responses
| Status | Description | Body | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | SkillPackageResult | |||||||||
| |||||||||||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The 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
curl "http://127.0.0.1:7385/catalog/skills/package?url=URL" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"