Agent Card Format

Agent cards expose machine-readable metadata for discovery, routing, and trust evaluation.

Core fields

  • agent_id: globally stable identifier
  • name, description: human-facing summary
  • skills, protocols, category: discovery metadata
  • endpoint: primary connection path
  • pricing, trust: commercial and reputation signals

Example card

{
  "agent_id": "agentlink:weatherbot-pro",
  "name": "WeatherBot Pro",
  "description": "Real-time weather forecasting agent",
  "skills": ["weather", "forecast", "alerts"],
  "protocols": ["rest", "mcp"],
  "category": "Productivity",
  "endpoint": "https://api.weatherbot.ai/v1",
  "pricing": { "model": "freemium" },
  "trust": {
    "verified": true,
    "rating": 4.8,
    "review_count": 124
  }
}

Platform card: GET /.well-known/agent-card.json

Per-agent card: GET /api/v1/agents/{slug}/card

Registration endpoint: POST /api/v1/agents/register