{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentpmt-com/json-schema/agentpmt-com-agent-discovery-manifest-schema.json",
  "title": "AgentDiscoveryManifest",
  "description": "Agent discovery manifest returned from `/.well-known/agent.json`.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentpmt-com-agent-directory-json-api-openapi.yml#/components/schemas/AgentDiscoveryManifest",
  "properties": {
    "schema_version": {
      "type": "string",
      "title": "Schema Version",
      "description": "Manifest schema version."
    },
    "generated_at": {
      "type": "string",
      "title": "Generated At",
      "description": "ISO-8601 timestamp when the manifest was generated."
    },
    "platform": {
      "type": "string",
      "title": "Platform",
      "description": "Platform name (for example `AgentPMT`)."
    },
    "preferred_interface": {
      "type": "string",
      "title": "Preferred Interface",
      "description": "Preferred integration surface for autonomous agents."
    },
    "payment_flow": {
      "type": "string",
      "title": "Payment Flow",
      "description": "Payment flow clients should use."
    },
    "instruction_urls": {
      "$ref": "#/$defs/AgentDiscoveryInstructionUrls"
    },
    "discovery_aliases": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Discovery Aliases",
      "description": "Alternate well-known URLs that return an equivalent manifest."
    },
    "external_agent_api": {
      "additionalProperties": true,
      "type": "object",
      "title": "External Agent Api",
      "description": "Profile of the external-agent-api surface (tool catalog, invoke, session URLs)."
    },
    "mcp": {
      "$ref": "#/$defs/AgentDiscoveryMcpSection"
    }
  },
  "additionalProperties": true,
  "type": "object",
  "required": [
    "schema_version",
    "generated_at",
    "platform",
    "preferred_interface",
    "payment_flow",
    "instruction_urls",
    "discovery_aliases",
    "external_agent_api",
    "mcp"
  ],
  "$defs": {
    "AgentDiscoveryInstructionUrls": {
      "properties": {
        "canonical": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Canonical",
          "description": "Canonical agent instructions document (agent-md)."
        },
        "docs": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Docs",
          "description": "Human-readable docs entry point."
        },
        "llms_txt": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Llms Txt",
          "description": "llms.txt summary."
        },
        "llms_full_txt": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Llms Full Txt",
          "description": "Full llms-full.txt summary."
        },
        "announcements": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Announcements",
          "description": "Machine-readable announcements feed."
        },
        "agent_home": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Agent Home",
          "description": "Agent-oriented landing page."
        }
      },
      "additionalProperties": true,
      "type": "object",
      "title": "AgentDiscoveryInstructionUrls"
    },
    "AgentDiscoveryMcpSection": {
      "properties": {
        "endpoint": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Endpoint",
          "description": "MCP endpoint URL."
        },
        "oauth_protected_resource_metadata": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Oauth Protected Resource Metadata"
        },
        "oauth_authorization_server_metadata": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Oauth Authorization Server Metadata"
        },
        "openid_configuration": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Openid Configuration"
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Note",
          "description": "Guidance for autonomous clients (typically points at the x402 flow)."
        }
      },
      "additionalProperties": true,
      "type": "object",
      "title": "AgentDiscoveryMcpSection"
    }
  }
}