{
  "awp_version": "0.1",
  "domain": "dialtoneapp.com",
  "intent": "DialtoneApp exposes a read-only discovery dataset for notable websites. Agents can browse ranked top-site pages, fetch per-domain detail records with robots.txt and llms.txt previews, and use DialtoneApp's markdown mirrors when citation-friendly reading is preferable to raw JSON.",
  "capabilities": {
    "streaming": true,
    "batch_actions": false,
    "webhooks": false,
    "pagination": "page",
    "idempotency": true
  },
  "auth": {
    "type": "none",
    "required_for": [],
    "optional_for": []
  },
  "mcp": {
    "version": "0.0.1",
    "endpoint": "https://dialtoneapp.com/mcp",
    "transport": {
      "type": "streamable-http",
      "responseMode": "sse"
    },
    "tools": [
      {
        "name": "list_top_sites",
        "description": "Read-only MCP tool that returns the public DialtoneApp top-sites API URL. Default target: https://dialtoneapp.com/api/v1/crawler/top-sites?page=1",
        "inputSchema": {
          "type": "object",
          "properties": {
            "page": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "description": "Optional 1-based page number for the public top-sites listing."
            }
          },
          "additionalProperties": false
        }
      }
    ]
  },
  "entities": {
    "top_site_list_entry": {
      "fields": {
        "domain": "string",
        "title": "string",
        "description": "string",
        "site_url": "url",
        "favicon_url": "url",
        "og_image_url": "url",
        "robots": "string",
        "llms": "string",
        "search_rank": "integer",
        "list_position": "integer",
        "crawled_at": "ISO8601"
      }
    },
    "pagination": {
      "fields": {
        "page": "integer",
        "pageSize": "integer",
        "total": "integer",
        "totalPages": "integer"
      }
    },
    "top_site_detail": {
      "fields": {
        "domain": "string",
        "title": "string",
        "description": "string",
        "site_url": "url",
        "homepage_url": "url",
        "homepage_final_url": "url",
        "favicon_url": "url",
        "og_image_url": "url",
        "robots": "string",
        "llms": "string",
        "robots_txt_url": "url",
        "llms_txt_url": "url",
        "llms_full_txt_url": "url",
        "search_rank": "integer",
        "list_position": "integer",
        "crawled_at": "ISO8601"
      }
    }
  },
  "actions": [
    {
      "id": "list_top_sites",
      "description": "List one public page of ranked sites from the DialtoneApp crawler dataset.",
      "auth_required": false,
      "inputs": {
        "page": {
          "type": "integer",
          "required": false,
          "default": 1,
          "description": "1-based page number for the public top-sites listing."
        }
      },
      "outputs": {
        "results": "array[top_site_list_entry]",
        "pagination": "object[pagination]"
      },
      "endpoint": "/api/v1/crawler/top-sites",
      "method": "GET",
      "rate_limit": "30/minute",
      "execution_model": "sync",
      "sensitivity": "standard",
      "reversible": false
    },
    {
      "id": "get_top_site_detail",
      "description": "Fetch the DialtoneApp detail record for one domain, including stored robots.txt and llms.txt previews when available.",
      "auth_required": false,
      "inputs": {
        "domain": {
          "type": "string",
          "required": true,
          "description": "Domain name or URL to resolve to a crawled top-site detail record."
        }
      },
      "outputs": {
        "site": "object[top_site_detail]"
      },
      "endpoint": "/api/v1/crawler/top-sites/{domain}",
      "method": "GET",
      "rate_limit": "30/minute",
      "execution_model": "sync",
      "sensitivity": "standard",
      "reversible": false
    }
  ],
  "agent_hints": {
    "preferred_structured_surface": "Use the /api/v1/crawler/top-sites endpoints when you need stable JSON fields or pagination.",
    "preferred_citation_surface": "Use /top-sites.md or /top-sites/{domain}/index.md when you need markdown better suited for quoting or summarization.",
    "preferred_mcp_surface": "Use https://dialtoneapp.com/mcp when you want the v0.0.1 DialtoneApp MCP surface. It currently exposes one read-only list_top_sites tool."
  },
  "agent_status": {
    "operational": true
  }
}