{
  "openapi": "3.1.0",
  "info": {
    "title": "ReadyDocs Compliance",
    "version": "1.1.0",
    "description": "US contractor compliance reference: licenses, insurance, permits, and costs required to legally operate as a trade contractor in a given city. 12 trades, 51 states, English and Spanish. In verified-record states, English answers are sourced fact-by-fact from official government sources with per-record verified_from URLs and verified_on dates. Reference data — not legal advice, not a licensing determination. The primary programmatic interface is the MCP endpoint at /api/mcp (Model Context Protocol, Streamable HTTP, no auth).",
    "contact": {
      "url": "https://compliance.thereadydocs.app/contact"
    }
  },
  "servers": [
    {
      "url": "https://compliance.thereadydocs.app"
    }
  ],
  "paths": {
    "/api/mcp": {
      "post": {
        "operationId": "mcp",
        "summary": "MCP endpoint (Streamable HTTP, JSON-RPC 2.0)",
        "description": "Model Context Protocol server exposing two tools. readydocs_compliance_lookup: { trade, city, state, language? } → compliance requirements as markdown with citations, sources, and verification dates. readydocs_compliance_coverage: { state? } → covered trades, states, and cities, including which states have verified records. Connect with any MCP client (Claude Code, Cursor, Codex) using transport 'streamable-http' and this URL. No authentication.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "JSON-RPC 2.0 request per the MCP specification."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC 2.0 response (or SSE stream) per the MCP specification."
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "llmsTxt",
        "summary": "Plain-text site description for AI agents",
        "responses": {
          "200": {
            "description": "text/plain agent discovery file."
          }
        }
      }
    },
    "/.well-known/mcp.json": {
      "get": {
        "operationId": "mcpManifest",
        "summary": "MCP server discovery manifest",
        "responses": {
          "200": {
            "description": "JSON manifest describing the MCP endpoint and tools."
          }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "operationId": "sitemap",
        "summary": "Full sitemap of human-readable guide pages",
        "responses": {
          "200": {
            "description": "XML sitemap."
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "Developer docs with install snippets and tool reference",
    "url": "https://compliance.thereadydocs.app/developers"
  }
}