{
  "specVersion": "1.0",
  "host": {
    "displayName": "Specoria",
    "documentationUrl": "https://specoria.com/developers/",
    "logoUrl": "https://specoria.com/logo.svg"
  },
  "entries": [
    {
      "identifier": "urn:air:specoria.com:api:scan",
      "displayName": "Specoria scan API",
      "type": "application/vnd.oai.openapi+json",
      "url": "https://specoria.com/openapi.json",
      "description": "POST https://app.specoria.com/v1/scan runs the free Specoria agent-readiness test on a public website and returns the score, level, critical blockers and every check as JSON. Needs an organization API key from the Specoria panel (Authorization: Bearer); rate-limited per key.",
      "tags": [
        "agent-readiness",
        "ecommerce",
        "ai-shopping-agents"
      ],
      "capabilities": [
        "scanStore"
      ],
      "representativeQueries": [
        "check whether AI shopping agents can read my online store",
        "run an agent readiness scan on a website and get the score as JSON",
        "which fixes would make my store easier for ChatGPT to shop"
      ],
      "version": "v1",
      "metadata": {
        "endpoint": "https://app.specoria.com/v1/scan",
        "method": "POST",
        "auth": "bearer",
        "auth_required": true,
        "docs_en": "https://specoria.com/developers/",
        "docs_tr": "https://specoria.com/tr/gelistiriciler/"
      }
    },
    {
      "identifier": "urn:air:specoria.com:mcp:customer",
      "displayName": "Specoria customer MCP server",
      "type": "application/mcp-server-card+json",
      "url": "https://specoria.com/.well-known/mcp.json",
      "description": "Remote MCP server at https://app.specoria.com/v1/mcp (Streamable HTTP, stateless, JSON responses): scan a public website and read the projects and tasks of the organization that owns the API key. Needs an organization API key from the Specoria panel (Authorization: Bearer).",
      "tags": [
        "agent-readiness",
        "ecommerce",
        "mcp"
      ],
      "capabilities": [
        "scan_store",
        "list_projects",
        "get_project_tasks"
      ],
      "representativeQueries": [
        "scan my store for AI agent readiness from my AI assistant",
        "list my Specoria projects and their latest scores",
        "what are the open fix tasks for my store in Specoria"
      ],
      "version": "1.0.0",
      "metadata": {
        "endpoint": "https://app.specoria.com/v1/mcp",
        "transport": "streamable-http",
        "auth": "bearer",
        "auth_required": true,
        "docs_en": "https://specoria.com/developers/",
        "docs_tr": "https://specoria.com/tr/gelistiriciler/"
      }
    }
  ]
}
