{
  "specVersion": "1.0",
  "host": {
    "displayName": "ClarCV",
    "identifier": "https://clarcv.com",
    "documentationUrl": "https://clarcv.com/docs/api.md",
    "logoUrl": "https://clarcv.com/logo192.png"
  },
  "entries": [
    {
      "identifier": "urn:air:clarcv.com:api:catalog",
      "displayName": "ClarCV public API catalog",
      "description": "RFC 9727 linkset of public HTTP APIs (templates, health).",
      "type": "application/linkset+json",
      "url": "https://clarcv.com/.well-known/api-catalog",
      "tags": ["api", "discovery", "linkset"],
      "representativeQueries": [
        "what public APIs does ClarCV expose",
        "where is the ClarCV API catalog",
        "list ClarCV machine-readable endpoints"
      ]
    },
    {
      "identifier": "urn:air:clarcv.com:docs:api",
      "displayName": "ClarCV API documentation",
      "description": "Markdown overview of public and authenticated ClarCV HTTP APIs.",
      "type": "text/markdown",
      "url": "https://clarcv.com/docs/api.md",
      "tags": ["docs", "api", "markdown"],
      "representativeQueries": [
        "how do I authenticate to the ClarCV API",
        "how do I list CV templates via HTTP",
        "what endpoints does ClarCV provide"
      ]
    },
    {
      "identifier": "urn:air:clarcv.com:api:templates",
      "displayName": "CV template list",
      "description": "JSON list of HTML CV templates (id, name, category, thumbnail). Applying a template requires auth.",
      "type": "application/json",
      "url": "https://clarcv.com/api/cvs/templates/",
      "tags": ["cv", "templates", "api"],
      "capabilities": ["ListTemplates"],
      "representativeQueries": [
        "what CV templates does ClarCV offer",
        "list resume designs available on ClarCV",
        "get ClarCV HTML template catalog"
      ]
    },
    {
      "identifier": "urn:air:clarcv.com:api:health",
      "displayName": "ClarCV health check",
      "description": "Process and database health. 200 when healthy; 503 when the database is down.",
      "type": "application/json",
      "url": "https://clarcv.com/health/",
      "tags": ["status", "health"],
      "capabilities": ["HealthCheck"],
      "representativeQueries": [
        "is ClarCV up",
        "ClarCV service health status",
        "check if the ClarCV API is available"
      ]
    },
    {
      "identifier": "urn:air:clarcv.com:docs:landing",
      "displayName": "ClarCV landing (Markdown)",
      "description": "Agent-readable Markdown twin of the Spanish landing page.",
      "type": "text/markdown",
      "url": "https://clarcv.com/es/index.md",
      "tags": ["docs", "markdown", "product"],
      "representativeQueries": [
        "what is ClarCV",
        "how do I improve my CV with ClarCV",
        "ClarCV pricing and how to start"
      ]
    },
    {
      "identifier": "urn:air:clarcv.com:mcp:public",
      "displayName": "ClarCV public MCP",
      "description": "Read-only MCP tools: service health and CV template list. No CV files.",
      "type": "application/mcp-server-card+json",
      "url": "https://clarcv.com/.well-known/mcp/server-card.json",
      "tags": ["mcp", "templates", "health"],
      "representativeQueries": [
        "list ClarCV CV templates over MCP",
        "is ClarCV healthy via MCP",
        "ClarCV MCP server card"
      ]
    },
    {
      "identifier": "urn:air:clarcv.com:docs:auth",
      "displayName": "ClarCV auth.md",
      "description": "How agents register and obtain a JWT for ClarCV APIs.",
      "type": "text/markdown",
      "url": "https://clarcv.com/auth.md",
      "tags": ["auth", "jwt", "markdown"],
      "representativeQueries": [
        "how do I authenticate an agent to ClarCV",
        "ClarCV JWT login for APIs",
        "register a ClarCV account for API access"
      ]
    },
    {
      "identifier": "urn:air:clarcv.com:skill:index",
      "displayName": "ClarCV agent skills",
      "description": "Discovery index of ClarCV Agent Skills (improve-cv, public API).",
      "type": "application/json",
      "url": "https://clarcv.com/.well-known/agent-skills/index.json",
      "tags": ["skills", "discovery"],
      "representativeQueries": [
        "ClarCV agent skills",
        "skill for improving a CV on ClarCV",
        "how to call ClarCV public APIs from an agent"
      ]
    }
  ]
}