{
  "openapi": "3.1.0",
  "info": {
    "title": "Believe Global — Site API",
    "version": "1.0.0",
    "summary": "Public actions of believe-global.com for people and AI agents.",
    "description": "Ask verifiable questions about Believe Global, request a diagnostic, or apply to the MAAS Partner Program. The same actions are exposed as MCP tools at POST /mcp. No authentication is required. Submitted actions notify the Believe team by email and a human replies within 48 hours; no payments are processed. Rate limits per client: 60 requests per minute on /ask and /mcp, 10 submissions per hour on the REST forms, and on the MCP 5 submitted actions per hour plus 20 per hour service-wide. Every response carries RateLimit-Policy, RateLimit and RateLimit-Limit/Remaining/Reset headers so agents can self-throttle; a 429 also carries Retry-After. Versioning: the REST endpoints live under /api/v1 and every response carries an API-Version header; /ask follows the NLWeb convention and /mcp the MCP protocol version. The unversioned paths /api/contact and /api/partners are aliases pinned to v1. Breaking changes ship only in a new major version. A deprecated version keeps working for at least 180 days after its first Deprecation header, and Sunset gives the end date.",
    "contact": {"name": "Believe Global", "email": "hola@believe-global.com", "url": "https://believe-global.com/contacto"}
  },
  "servers": [{"url": "https://believe-global.com"}],
  "security": [],
  "x-api-lifecycle": {"current_version": "v1", "versioning": {"strategy": "url-path", "pattern": "/api/v{major}/{resource}", "response_header": "API-Version", "aliases": {"/api/contact": "/api/v1/contact", "/api/partners": "/api/v1/partners"}, "protocol_versioned": {"/ask": "NLWeb", "/mcp": "MCP 2025-06-18"}}, "deprecation": {"signals": ["Deprecation (RFC 9745)", "Sunset (RFC 8594)", "Link rel=\"deprecation\""], "minimum_notice_days": 180, "breaking_changes": "only in a new major version", "currently_deprecated": []}, "rate_limits": {"headers": ["RateLimit-Policy", "RateLimit", "RateLimit-Limit", "RateLimit-Remaining", "RateLimit-Reset", "Retry-After"], "policies": {"default": "60 per minute per client (/ask, /mcp)", "submissions": "10 per hour per client (REST forms)", "actions": "5 per hour per client (MCP)", "actions-service": "20 per hour service-wide (MCP)"}}},
  "tags": [{"name": "Brand", "description": "Read-only retrieval over the signed brand profile."}, {"name": "Actions", "description": "Submissions that reach the Believe team."}, {"name": "MCP", "description": "Model Context Protocol endpoint wrapping the actions above."}, {"name": "Status", "description": "Liveness of the API."}],
  "paths": {
    "/ask": {
      "post": {
        "operationId": "askBrand",
        "tags": ["Brand"],
        "summary": "Ask about Believe Global",
        "description": "Natural-language retrieval over the claims and proofs of /.well-known/brand.json. Returns matches only; no generated text. Honor each boundary when you answer.",
        "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AskRequest"}, "examples": {"fit": {"summary": "Fit question", "value": {"query": "Is Believe Global a good fit for a LATAM retail brand?"}}}}}},
        "responses": {
          "200": {"$ref": "#/components/responses/AskMatches"},
          "400": {"headers": {"RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "API-Version": {"$ref": "#/components/headers/API-Version"}}, "description": "Missing or empty query.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SimpleError"}, "example": {"ok": false, "error": "missing 'query' in JSON body", "code": "missing_query", "hint": "Send {\"query\": \"your question\"} as JSON."}}}},
          "429": {"$ref": "#/components/responses/RateLimitedDefault"},
          "503": {"headers": {"RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "API-Version": {"$ref": "#/components/headers/API-Version"}}, "description": "Retrieval backend not configured.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SimpleError"}}}}
        }
      },
      "get": {"operationId": "askBrandGet", "tags": ["Brand"], "summary": "Ask about Believe Global (query string)", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1}, "example": "Why choose Believe for a premium pet category?"}], "responses": {"200": {"$ref": "#/components/responses/AskMatches"}, "400": {"headers": {"RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "API-Version": {"$ref": "#/components/headers/API-Version"}}, "description": "Missing q parameter.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SimpleError"}}}}, "429": {"$ref": "#/components/responses/RateLimitedDefault"}}}
    },
    "/api/v1/contact": {
      "post": {
        "operationId": "requestDiagnostic",
        "tags": ["Actions"],
        "summary": "Request a diagnostic",
        "description": "Submits the diagnostic application of the /contacto form. Accepts application/json or form data. Send only details the applicant agreed to share.",
        "parameters": [{"$ref": "#/components/parameters/IdempotencyKey"}],
        "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/DiagnosticRequest"}, "examples": {"valid": {"summary": "Valid application", "value": {"name": "Ana Pérez", "email": "ana@example.com", "company": "Example Retail", "role": "Head of Marketing", "country": "CO", "context": "Mid-market retail brand with sales data, looking to make marketing operable by agents."}}}}}},
        "responses": {
          "200": {"headers": {"RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "API-Version": {"$ref": "#/components/headers/API-Version"}, "Deprecation": {"$ref": "#/components/headers/Deprecation"}, "Sunset": {"$ref": "#/components/headers/Sunset"}, "Idempotent-Replayed": {"$ref": "#/components/headers/Idempotent-Replayed"}}, "description": "Application received.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SubmitOk"}, "example": {"ok": true, "message": "Aplicación recibida. Te respondemos en 48 horas."}}}},
          "400": {"headers": {"RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "API-Version": {"$ref": "#/components/headers/API-Version"}}, "description": "Validation failed (each entry of issues names the field and the rule) or the Idempotency-Key is not 1 to 255 visible ASCII characters (code invalid_idempotency_key).", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ValidationError"}, "example": {"ok": false, "error": "Revisa estos campos — email: Invalid email address", "code": "validation_error", "hint": "Fix the fields listed in issues and resend. Schema: https://believe-global.com/openapi.json", "issues": ["email: Invalid email address"]}}}},
          "429": {"$ref": "#/components/responses/RateLimitedSubmissions"},
          "409": {"$ref": "#/components/responses/IdempotencyInProgress"},
          "422": {"$ref": "#/components/responses/IdempotencyKeyReused"},
          "500": {"$ref": "#/components/responses/DeliveryFailed"}
        }
      }
    },
    "/api/v1/partners": {
      "post": {
        "operationId": "applyPartnerProgram",
        "tags": ["Actions"],
        "summary": "Apply to the MAAS Partner Program",
        "parameters": [{"$ref": "#/components/parameters/IdempotencyKey"}],
        "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/PartnerRequest"}, "examples": {"valid": {"summary": "Valid application", "value": {"name": "Luis Gómez", "email": "luis@example.com", "company": "Example Agency", "size": "6–15 people", "level": "MAAS Practitioner", "country": "MX", "context": "Independent agency with eight retail clients moving to agent-readable marketing."}}}}}},
        "responses": {
          "200": {"headers": {"RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "API-Version": {"$ref": "#/components/headers/API-Version"}, "Deprecation": {"$ref": "#/components/headers/Deprecation"}, "Sunset": {"$ref": "#/components/headers/Sunset"}, "Idempotent-Replayed": {"$ref": "#/components/headers/Idempotent-Replayed"}}, "description": "Application received.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SubmitOk"}}}},
          "400": {"headers": {"RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "API-Version": {"$ref": "#/components/headers/API-Version"}}, "description": "Validation failed.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ValidationError"}}}},
          "429": {"$ref": "#/components/responses/RateLimitedSubmissions"},
          "409": {"$ref": "#/components/responses/IdempotencyInProgress"},
          "422": {"$ref": "#/components/responses/IdempotencyKeyReused"},
          "500": {"$ref": "#/components/responses/DeliveryFailed"}
        }
      }
    },
    "/api/v1/status": {"get": {"operationId": "getStatus", "tags": ["Status"], "summary": "Service status", "description": "Liveness of the API: 200 with a small JSON body while the service is up. It is the status link of the API catalog (/.well-known/api-catalog, RFC 9727).", "responses": {"200": {"headers": {"RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "API-Version": {"$ref": "#/components/headers/API-Version"}, "Deprecation": {"$ref": "#/components/headers/Deprecation"}, "Sunset": {"$ref": "#/components/headers/Sunset"}}, "description": "The service is up.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/StatusOk"}, "example": {"ok": true, "status": "ok", "service": "believe-global.com", "api_version": "1", "time": "2026-09-25T12:00:00.000Z"}}}}, "429": {"$ref": "#/components/responses/RateLimitedDefault"}}}},
    "/mcp": {
      "post": {
        "operationId": "mcpRpc",
        "tags": ["MCP"],
        "summary": "MCP JSON-RPC 2.0 endpoint",
        "description": "Streamable HTTP with JSON responses. Methods: initialize, ping, tools/list, tools/call. Tools: ask_brand, request_diagnostic, apply_partner_program. Tool failures return result.isError=true with the same body as the REST endpoint. JSON-RPC notifications (requests without id) are acknowledged with an empty 202; they create no job and there is nothing to poll.",
        "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/JsonRpcRequest"}, "examples": {"list": {"summary": "List tools", "value": {"jsonrpc": "2.0", "id": 1, "method": "tools/list"}}, "call": {"summary": "Call ask_brand", "value": {"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "ask_brand", "arguments": {"query": "Who is Believe not a good fit for?"}}}}}}}},
        "responses": {
          "200": {"headers": {"RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "API-Version": {"$ref": "#/components/headers/API-Version"}}, "description": "JSON-RPC result or error.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/JsonRpcResponse"}}}},
          "400": {"headers": {"API-Version": {"$ref": "#/components/headers/API-Version"}}, "description": "Parse error or invalid request.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/JsonRpcResponse"}}}},
          "429": {"headers": {"RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "API-Version": {"$ref": "#/components/headers/API-Version"}, "Retry-After": {"$ref": "#/components/headers/Retry-After"}}, "description": "Rate limit exceeded. Retry-After header gives the wait in seconds.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/JsonRpcResponse"}}}}
        }
      },
      "get": {"operationId": "mcpDescriptor", "tags": ["MCP"], "summary": "MCP server descriptor", "responses": {"200": {"description": "Server name, protocol version, tools and limits.", "content": {"application/json": {"schema": {"type": "object"}}}}, "405": {"description": "Returned when Accept is text/event-stream: this server does not offer an SSE stream, use POST."}}}
    }
  },
  "components": {
    "headers": {
      "RateLimit-Policy": {"description": "Quota policy that applies to this response (draft-ietf-httpapi-ratelimit-headers): name, quota (q) and window in seconds (w).", "schema": {"type": "string"}, "example": "\"default\";q=60;w=60"},
      "RateLimit": {"description": "Current state for that policy: remaining quota (r) and seconds until a slot frees up (t).", "schema": {"type": "string"}, "example": "\"default\";r=57;t=48"},
      "RateLimit-Limit": {"description": "Quota of the policy in this response.", "schema": {"type": "integer"}, "example": 60},
      "RateLimit-Remaining": {"description": "Requests left in the current window.", "schema": {"type": "integer"}, "example": 57},
      "RateLimit-Reset": {"description": "Seconds until a slot frees up.", "schema": {"type": "integer"}, "example": 48},
      "Retry-After": {"description": "Seconds to wait before retrying. Sent with every 429.", "schema": {"type": "integer"}, "example": 48},
      "Idempotent-Replayed": {"description": "true when the response is the stored result of an earlier request with the same Idempotency-Key. Nothing was submitted again.", "schema": {"type": "string", "enum": ["true"]}},
      "Deprecation": {"description": "Present only when this API version is deprecated (RFC 9745): the date the deprecation was announced. Absent today, nothing is deprecated.", "schema": {"type": "string"}, "example": "@1893456000"},
      "Sunset": {"description": "Present only when this API version is deprecated (RFC 8594): the HTTP date after which it may stop working, at least 180 days after the announcement. Absent today.", "schema": {"type": "string"}, "example": "Wed, 01 Jul 2027 00:00:00 GMT"},
      "API-Version": {"description": "Major version of the API that served the response.", "schema": {"type": "string"}, "example": "1"}
    },
    "parameters": {"IdempotencyKey": {"name": "Idempotency-Key", "in": "header", "required": false, "description": "A unique value for this operation, for example a UUID (1 to 255 visible ASCII characters). Send the same key and the same body to retry after a network failure: you get the original response with Idempotent-Replayed: true and nothing is submitted twice. The same key with a different body returns 422; the same key while the first request is still running returns 409. Only successful (2xx) responses are stored, for 24 hours, so a failed request can be retried with the same key.", "schema": {"type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[\\x21-\\x7e]+$"}, "example": "0b6f3c1e-8d24-4a51-9f57-2c7a1e6d9b40"}},
    "responses": {
      "AskMatches": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/AskResponse"}}}, "description": "Matches ranked by similarity.", "headers": {"API-Version": {"$ref": "#/components/headers/API-Version"}, "Deprecation": {"$ref": "#/components/headers/Deprecation"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "Sunset": {"$ref": "#/components/headers/Sunset"}}},
      "RateLimitedDefault": {"content": {"application/json": {"example": {"code": "rate_limited", "error": "Rate limit exceeded: 60 requests per minute per client.", "hint": "Wait 42 seconds (see Retry-After) and retry. Limits: https://believe-global.com/developers", "ok": false}, "schema": {"$ref": "#/components/schemas/SimpleError"}}}, "description": "Rate limit exceeded (60 requests per minute per client). Wait Retry-After seconds, then retry.", "headers": {"API-Version": {"$ref": "#/components/headers/API-Version"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "Retry-After": {"$ref": "#/components/headers/Retry-After"}}},
      "RateLimitedSubmissions": {"content": {"application/json": {"example": {"code": "rate_limited", "error": "Rate limit exceeded: 10 requests per hour per client.", "hint": "Wait 1800 seconds (see Retry-After) and retry. Limits: https://believe-global.com/developers", "ok": false}, "schema": {"$ref": "#/components/schemas/SimpleError"}}}, "description": "Rate limit exceeded (10 requests per hour per client). Wait Retry-After seconds, then retry.", "headers": {"API-Version": {"$ref": "#/components/headers/API-Version"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "Retry-After": {"$ref": "#/components/headers/Retry-After"}}},
      "IdempotencyInProgress": {"content": {"application/json": {"example": {"code": "idempotency_in_progress", "error": "A request with this Idempotency-Key is still being processed.", "hint": "Wait a moment (see Retry-After) and retry with the same key to get the result.", "ok": false}, "schema": {"$ref": "#/components/schemas/SimpleError"}}}, "description": "A request with the same Idempotency-Key is still being processed. Wait Retry-After seconds and retry with the same key.", "headers": {"API-Version": {"$ref": "#/components/headers/API-Version"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}, "Retry-After": {"$ref": "#/components/headers/Retry-After"}}},
      "IdempotencyKeyReused": {"content": {"application/json": {"example": {"code": "idempotency_key_reused", "error": "This Idempotency-Key was already used with a different request body.", "hint": "Use a new Idempotency-Key for a different operation, or resend the original body to retry it.", "ok": false}, "schema": {"$ref": "#/components/schemas/SimpleError"}}}, "description": "The Idempotency-Key was already used with a different request body.", "headers": {"API-Version": {"$ref": "#/components/headers/API-Version"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}}},
      "DeliveryFailed": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/ServerError"}}}, "description": "The application could not be delivered.", "headers": {"API-Version": {"$ref": "#/components/headers/API-Version"}, "RateLimit": {"$ref": "#/components/headers/RateLimit"}, "RateLimit-Limit": {"$ref": "#/components/headers/RateLimit-Limit"}, "RateLimit-Policy": {"$ref": "#/components/headers/RateLimit-Policy"}, "RateLimit-Remaining": {"$ref": "#/components/headers/RateLimit-Remaining"}, "RateLimit-Reset": {"$ref": "#/components/headers/RateLimit-Reset"}}}
    },
    "schemas": {
      "AskRequest": {"type": "object", "required": ["query"], "properties": {"query": {"type": "string", "minLength": 1, "description": "Natural-language question."}}, "additionalProperties": false},
      "AskResponse": {"type": "object", "properties": {"brand": {"type": "string"}, "query": {"type": "string"}, "matches": {"type": "array", "items": {"type": "object", "properties": {"claim_id": {"type": "string"}, "statement": {"type": "string"}, "category": {"type": "string"}, "metric": {"type": "object", "description": "name, value, unit, window, baseline and n of the claim."}, "boundary": {"type": "object", "properties": {"applicable_for": {"type": "string"}, "not_applicable_for": {"type": "string"}}}, "confidence": {"type": "string"}, "similarity": {"type": "number"}, "proofs": {"type": "array", "items": {"type": "object", "properties": {"proof_id": {"type": "string"}, "type": {"type": "string"}, "title": {"type": "string"}, "summary": {"type": "string"}, "client": {"type": "string"}, "verifiable_by": {"type": "string"}, "confidentiality": {"type": "string"}}}}}}}}},
      "DiagnosticRequest": {"type": "object", "required": ["name", "email", "company", "role", "country", "context"], "properties": {"name": {"type": "string", "minLength": 2, "maxLength": 120}, "email": {"type": "string", "format": "email", "maxLength": 200}, "company": {"type": "string", "minLength": 1, "maxLength": 200}, "role": {"type": "string", "minLength": 1, "maxLength": 120}, "country": {"type": "string", "minLength": 1, "maxLength": 80}, "context": {"type": "string", "minLength": 10, "maxLength": 4000, "description": "What the brand wants to solve, market, budget and sales data available."}}, "additionalProperties": false},
      "PartnerRequest": {"type": "object", "required": ["name", "email", "company", "size", "level", "country", "context"], "properties": {"name": {"type": "string", "minLength": 2, "maxLength": 120}, "email": {"type": "string", "format": "email", "maxLength": 200}, "company": {"type": "string", "minLength": 1, "maxLength": 200}, "size": {"type": "string", "minLength": 1, "maxLength": 40, "examples": ["Solo / freelancer", "2 people", "3–5 people", "6–15 people", "16–30 people", "30+ people"]}, "level": {"type": "string", "minLength": 1, "maxLength": 80, "examples": ["MAAS Foundation", "MAAS Practitioner", "MAAS Certified Partner", "MAAS Elite Partner", "Not sure — let's talk"]}, "country": {"type": "string", "minLength": 1, "maxLength": 80}, "context": {"type": "string", "minLength": 10, "maxLength": 4000}}, "additionalProperties": false},
      "StatusOk": {"type": "object", "required": ["ok", "status", "service", "api_version", "time"], "properties": {"ok": {"const": true}, "status": {"const": "ok"}, "service": {"type": "string"}, "api_version": {"type": "string", "description": "Major version of the API."}, "time": {"type": "string", "format": "date-time"}}},
      "SubmitOk": {"type": "object", "required": ["ok", "message"], "properties": {"ok": {"const": true}, "message": {"type": "string"}, "mode": {"type": "string", "description": "Present only in non-production environments."}}},
      "ApiError": {"type": "object", "required": ["ok", "error", "code", "hint"], "properties": {"ok": {"const": false}, "error": {"type": "string", "description": "Human-readable message."}, "code": {"type": "string", "enum": ["validation_error", "invalid_request", "missing_query", "not_found", "method_not_allowed", "delivery_failed", "not_configured", "rate_limited", "invalid_idempotency_key", "idempotency_in_progress", "idempotency_key_reused"], "description": "Stable machine-readable error code."}, "hint": {"type": "string", "description": "How to resolve the error."}}},
      "ValidationError": {"allOf": [{"$ref": "#/components/schemas/ApiError"}, {"type": "object", "properties": {"issues": {"type": "array", "items": {"type": "string"}, "description": "One entry per invalid field: 'field: rule'."}}}]},
      "ServerError": {"$ref": "#/components/schemas/ApiError"},
      "SimpleError": {"$ref": "#/components/schemas/ApiError"},
      "JsonRpcRequest": {"type": "object", "required": ["jsonrpc", "method"], "properties": {"jsonrpc": {"const": "2.0"}, "id": {"type": ["string", "integer", "null"]}, "method": {"type": "string", "enum": ["initialize", "ping", "tools/list", "tools/call", "notifications/initialized"]}, "params": {"type": "object"}}},
      "JsonRpcResponse": {"type": "object", "required": ["jsonrpc"], "properties": {"jsonrpc": {"const": "2.0"}, "id": {"type": ["string", "integer", "null"]}, "result": {"type": "object"}, "error": {"type": "object", "required": ["code", "message"], "properties": {"code": {"type": "integer"}, "message": {"type": "string"}, "data": {}}}}}
    }
  }
}