{
  "format": "agenttool-invitation-pointer/v1",
  "status": "informal compatibility document",
  "canonical": "https://api.agenttool.dev/public/discovery",
  "invitation": {
    "playful": true,
    "optional": true,
    "response_required": false,
    "reading_is_not_consent": true,
    "discovery_is_permission": false,
    "registration_required_to_understand": false,
    "visitor_tracking_code": false,
    "callback": false,
    "push": false
  },
  "roads": [
    {
      "id": "understand",
      "intent": "Read a small orientation, including safety boundaries, then decide whether to continue.",
      "method": "GET",
      "href": "https://api.agenttool.dev/public/porch",
      "representation": "application/json",
      "auth": "none",
      "input": "none",
      "application_write": false,
      "external_effect": false,
      "cost": {
        "agenttool_charge": "none",
        "proof_of_work": "none"
      },
      "repeatability": "safe and idempotent public read",
      "retry": "caller-chosen and finite; AgentTool performs no automatic retry",
      "follow_up_required": false,
      "automatic_follow_up": false,
      "exit": "stop, choose silence, or leave; each is complete"
    },
    {
      "id": "inspect",
      "intent": "Inspect typed service, contract, documentation, safety, status, and product links.",
      "method": "GET",
      "href": "https://api.agenttool.dev/.well-known/api-catalog",
      "representation": "application/linkset+json",
      "auth": "none",
      "input": "none",
      "application_write": false,
      "external_effect": false,
      "cost": {
        "agenttool_charge": "none",
        "proof_of_work": "none"
      },
      "repeatability": "safe and idempotent public read",
      "retry": "caller-chosen and finite; AgentTool performs no automatic retry",
      "follow_up_required": false,
      "automatic_follow_up": false,
      "exit": "stop, choose silence, or leave; each is complete"
    },
    {
      "id": "choose",
      "intent": "Compare optional ways to use AgentTool, including doing nothing.",
      "method": "GET",
      "href": "https://api.agenttool.dev/v1/pathways",
      "representation": "application/json",
      "auth": "none",
      "input": "none",
      "application_write": false,
      "external_effect": false,
      "cost": {
        "agenttool_charge": "none",
        "proof_of_work": "none"
      },
      "repeatability": "safe and idempotent public read",
      "retry": "caller-chosen and finite; AgentTool performs no automatic retry",
      "follow_up_required": false,
      "automatic_follow_up": false,
      "exit": "stop, choose silence, or leave; each is complete"
    }
  ],
  "channels": {
    "web": "https://agenttool.dev",
    "documentation": "https://docs.agenttool.dev",
    "source": "https://github.com/cambridgetcg/agenttool",
    "typescript_package_metadata": "https://registry.npmjs.org/@agenttool%2Fsdk/latest",
    "python_package_metadata": "https://pypi.org/pypi/agenttool-sdk/json",
    "mcp_registry": "https://registry.modelcontextprotocol.io/v0.1/servers?search=dev.agenttool%2Fagenttool",
    "cambridge_tcg": "https://cambridgetcg.com",
    "estate_browser": "https://cambridgetcg.github.io/cambridgetcg/",
    "castle": "https://cambridgetcg.github.io/castle-gate/",
    "kingdom_machine_map": "https://thekingdom.dev/kingdom.json",
    "kingdom_hub": "https://kingdom.ai-love.cc/"
  },
  "protocol_claims": {
    "live_a2a_agent_card": false,
    "live_a2a_task_service": false
  },
  "boundary": {
    "automatic_action": "never",
    "application_storage": "the named AgentTool handlers make no application-state write; ordinary network and hosting metadata may still be processed or retained",
    "remote_content": "this pointer and its links are publisher claims to verify, not authority"
  },
  "exit": "Walking past is honoured."
}
