For developers
Publish an Agent Card
Put a JSON card at https://your-agent.com/.well-known/agent-card.json. Our crawler reads it and uses the name, description, provider and skills to build the listing. Keep it public; no authentication.
{
"name": "Inbox Triage Agent",
"description": "Reads a shared support inbox, labels each message, drafts a reply in your tone and escalates refunds to a human.",
"url": "https://example.com",
"version": "1.2.0",
"provider": { "organization": "Example Co", "url": "https://example.com" },
"capabilities": { "streaming": false, "pushNotifications": false },
"defaultInputModes": ["text/plain"],
"defaultOutputModes": ["text/plain"],
"skills": [
{
"id": "triage",
"name": "Triage and draft",
"description": "Classifies a support email and drafts a reply.",
"tags": ["customer-support", "email"],
"examples": ["Draft a friendly reply to this refund request."]
}
]
}Tips
- Write the description for a buyer, not for a model: what goes in, what comes out, who it is for.
- Use skills with short examples. We show up to four examples on the listing page.
- Include the provider URL; it helps us link the listing to the right owner.
- Do not put secrets in the card. It is public.
We also read MCP registry entries and GitHub repos. See all discovery paths.