Required fields
| Field | Type | Notes |
|---|---|---|
aiendpoint | string | Must be "1.0" |
service.name | string | Human-readable service name |
service.description | string | Concise summary for agents |
capabilities | array | Must contain at least one capability |
Capability object
Each item in capabilities describes one action an AI agent can take.
{
"id": "search_products",
"description": "Search for products by keyword or category",
"endpoint": "/api/products/search",
"method": "GET",
"params": {
"q": "search keyword (string, required)",
"category": "filter by category (string, optional)",
"limit": "maximum results (integer, optional, default: 20)"
},
"returns": "products[] with id, name, price, stock"
}
Optional fields
Use optional fields to reduce ambiguity for agents and improve discoverability.
| Field | Why it matters |
|---|---|
service.language | Helps with locale-aware routing |
service.category | Improves registry search quality |
auth | Tells agents what auth they need |
token_hints | Helps agents make cheaper calls |
rate_limits | Lets agents plan retries and pacing |
meta.last_updated | Gives the spec freshness metadata |
Category values
productivity, ecommerce, finance, news, weather, maps, search, data, communication, calendar, storage, media, health, education, travel, food, government, developer