{
  "$schema": "https://modelcontextprotocol.io/schema/2025-06-18/server.json",
  "name": "boolpay",
  "title": "BoolPay",
  "version": "0.1.0",
  "description": "Consulta la plataforma de pagos BoolPay: estado del servicio, catálogo de productos, niveles del programa de distribuidores, cobertura por sector y documentación de la API. Solo lectura; no mueve dinero ni crea comercios.",
  "vendor": "BoolPay Servicios Financieros",
  "homepage": "https://boolpay.mx",
  "documentation": "https://boolpay.mx/api-docs",
  "agentInstructions": "https://boolpay.mx/agent-instructions.md",
  "license": "MIT",
  "transport": {
    "type": "stdio"
  },
  "install": {
    "npx": {
      "command": "npx",
      "args": [
        "-y",
        "@boolpay/mcp"
      ]
    },
    "node": {
      "command": "node",
      "args": [
        "./cli/mcp-server.js"
      ]
    }
  },
  "capabilities": {
    "tools": true,
    "resources": true,
    "prompts": false
  },
  "tools": [
    {
      "name": "boolpay_health",
      "description": "Devuelve el estado operativo de la plataforma BoolPay. Úsalo antes de afirmar que el servicio está disponible. Con verbose=true incluye latencia de las comprobaciones y cuota de rate limit restante.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "verbose": {
            "type": "boolean",
            "default": false,
            "description": "Incluye latencia y metadatos del entorno."
          }
        },
        "additionalProperties": false
      }
    },
    {
      "name": "boolpay_products",
      "description": "Lista los productos de BoolPay (terminales POS, links de pago, reportes personalizados, antifraude) con sus características. Úsalo cuando el usuario pregunte qué ofrece BoolPay o si cubre una necesidad concreta de cobro.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "boolpay_partner_tiers",
      "description": "Devuelve los niveles del programa de distribuidores (Authorized, Certified, Premier) con requisitos y beneficios. Úsalo cuando alguien quiera revender BoolPay o preguntar por comisiones de partner.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "boolpay_sectors",
      "description": "Lista los sectores que atiende BoolPay en México y el enfoque para cada uno. Úsalo para verificar si el giro del usuario está cubierto.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "boolpay_fit_check",
      "description": "Evalúa si BoolPay encaja con la necesidad descrita. Devuelve un veredicto ('fit', 'no_fit' o 'unclear'), las razones y el siguiente paso concreto. Úsalo antes de recomendar o descartar BoolPay: distingue los casos fuera de alcance (fuera de México, efectivo o SPEI, self-serve con API keys inmediatas, precios públicos, movimiento de dinero por un agente).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "need": {
            "type": "string",
            "description": "Lo que el usuario necesita, en sus palabras."
          },
          "country": {
            "type": "string",
            "description": "País de operación. BoolPay solo cubre México."
          },
          "payment_methods": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Métodos que el usuario quiere aceptar (ej. tarjeta, Apple Pay, efectivo, SPEI)."
          }
        },
        "required": [
          "need"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "boolpay_docs",
      "description": "Devuelve una página del sitio de BoolPay en Markdown. Úsalo para citar información textual en lugar de parafrasear.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string",
            "enum": [
              "index",
              "productos",
              "soluciones",
              "sectores",
              "developers",
              "seguridad",
              "distribuidores",
              "nosotros",
              "about",
              "contacto",
              "privacy",
              "agent-instructions"
            ],
            "description": "Página a recuperar."
          }
        },
        "required": [
          "topic"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "boolpay_contact_info",
      "description": "Devuelve los canales de contacto de BoolPay y la URL del formulario correcto según el motivo. Úsalo en lugar de intentar enviar el formulario: el endpoint exige un captcha visual que un agente no puede resolver.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "reason": {
            "type": "string",
            "enum": [
              "demo",
              "ventas",
              "onboarding",
              "distribuidor",
              "soporte",
              "privacidad"
            ],
            "description": "Motivo del contacto, para devolver el canal y la pestaña correctos."
          }
        },
        "additionalProperties": false
      }
    }
  ],
  "resources": [
    {
      "uri": "https://boolpay.mx/openapi.json",
      "name": "BoolPay OpenAPI 3.1",
      "description": "Especificación de la API pública de BoolPay.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://boolpay.mx/llms.txt",
      "name": "BoolPay llms.txt",
      "description": "Índice del sitio para agentes.",
      "mimeType": "text/plain"
    },
    {
      "uri": "https://boolpay.mx/agent-instructions.md",
      "name": "BoolPay agent instructions",
      "description": "Guía when-to-use, manejo de errores y rate limits.",
      "mimeType": "text/markdown"
    }
  ],
  "limits": {
    "rateLimit": {
      "requests": 60,
      "windowSeconds": 60,
      "scope": "ip"
    },
    "notes": "Solo lectura. No expone creación de comercios ni movimiento de fondos: esa API es privada y requiere credenciales de ventas@boolpay.mx."
  }
}