{
  "openapi": "3.1.0",
  "info": {
    "title": "Centro Estética Madrid Chic - Agent & Web API",
    "description": "Machine-readable endpoints and agent discovery services for Centro Estética Madrid Chic (Bienestar Chic).",
    "version": "1.0.0",
    "contact": {
      "name": "Centro Estética Madrid Chic",
      "url": "https://centroesteticamadrid-chic.com.es",
      "telephone": "+34 91 57 99 617"
    }
  },
  "servers": [
    {
      "url": "https://centroesteticamadrid-chic.com.es",
      "description": "Production server"
    }
  ],
  "paths": {
    "/.well-known/api-catalog": {
      "get": {
        "summary": "RFC 9727 API Catalog",
        "description": "Provides machine-readable linkset of discoverable APIs and endpoints.",
        "responses": {
          "200": {
            "description": "API Catalog Linkset JSON",
            "content": {
              "application/linkset+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/sitemap-index.xml": {
      "get": {
        "summary": "XML Sitemap Index",
        "description": "Index of all pages, treatments, and blog posts with hreflang alternate links.",
        "responses": {
          "200": {
            "description": "XML Sitemap Index",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/rss.xml": {
      "get": {
        "summary": "RSS Feed",
        "description": "Syndication feed of latest beauty, health, and aesthetics blog articles.",
        "responses": {
          "200": {
            "description": "RSS Feed XML",
            "content": {
              "application/rss+xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/robots.txt": {
      "get": {
        "summary": "Robots & AI Directives",
        "description": "Directives for web robots and AI search engines.",
        "responses": {
          "200": {
            "description": "Robots text file",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/openid-configuration": {
      "get": {
        "summary": "OpenID Connect Discovery 1.0 Metadata",
        "description": "Returns OpenID Connect configuration parameters, issuer, endpoints, and supported grant types.",
        "responses": {
          "200": {
            "description": "OIDC discovery configuration JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/oauth-authorization-server": {
      "get": {
        "summary": "OAuth 2.0 Authorization Server Metadata (RFC 8414)",
        "description": "Returns OAuth 2.0 authorization server metadata including token endpoint and authorization endpoint.",
        "responses": {
          "200": {
            "description": "OAuth 2.0 authorization server metadata JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/jwks.json": {
      "get": {
        "summary": "JSON Web Key Set (JWKS)",
        "description": "Returns public cryptographic keys used for verifying tokens issued by the authorization server.",
        "responses": {
          "200": {
            "description": "JWKS key set JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/oauth-protected-resource": {
      "get": {
        "summary": "OAuth 2.0 Protected Resource Metadata (RFC 9728)",
        "description": "Returns OAuth 2.0 protected resource metadata indicating authorization servers, resource identifier, and supported scopes.",
        "responses": {
          "200": {
            "description": "OAuth 2.0 protected resource metadata JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/auth.md": {
      "get": {
        "summary": "Auth.md Agent Registration Specification",
        "description": "Instructions for AI agents to discover, register, claim, and authenticate with services.",
        "responses": {
          "200": {
            "description": "Auth.md specification in Markdown",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/mcp/server-card.json": {
      "get": {
        "summary": "MCP Server Card (SEP-1649 / SEP-2127)",
        "description": "Model Context Protocol server card metadata defining serverInfo, transport endpoint, and capabilities.",
        "responses": {
          "200": {
            "description": "MCP Server Card JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "summary": "Agent Skills Discovery Index (v0.2.0)",
        "description": "Standardized index of domain-specific skills for AI agents with sha256 integrity digests.",
        "responses": {
          "200": {
            "description": "Agent skills index JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  }
}