A2A AgentCard endpoint: /.well-known/agent.json

[artugro]

Context

A2A expects agents to publish their card at /.well-known/agent.json. Intuno already serves /.well-known/mcp/server-card.json for MCP marketplace scanners. Adding the A2A equivalent would make Intuno discoverable by A2A-compatible systems and crawlers.

Proposed Changes

Add a GET /.well-known/agent.json endpoint in src/main.py that returns an A2A-compatible AgentCard:

{
  "name": "Intuno Agent Network",
  "description": "Registry, broker, and orchestrator for AI agents",
  "url": "https://api.intuno.ai",
  "version": "0.1.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false
  },
  "skills": [
    {
      "id": "discover",
      "name": "Discover Agents",
      "description": "Semantic search for AI agents"
    },
    {
      "id": "invoke",
      "name": "Invoke Agent",
      "description": "Execute an agent with input data"
    },
    {
      "id": "orchestrate",
      "name": "Orchestrate Task",
      "description": "Multi-step task orchestration"
    }
  ],
  "authentication": {
    "schemes": ["apiKey", "bearer"]
  }
}

Files

• src/main.py — add endpoint (similar pattern to existing mcp_server_card())