Documentación / Documentation

Qué es

Un servidor MCP remoto (Streamable HTTP) y una API HTTP con 482 utilidades deterministas: documentos de LatAm y España (NIT, RFC, CURP, CPF, CNPJ, CUIT, RUT…), texto en español, finanzas e IVA, fechas y festivos, Pix/EMVCo, QR, JSON, hashes y más. Gratis y sin llave. Cada herramienta es una función pura: sin red, sin estado, solo lectura (todas llevan readOnlyHint). Cada resultado trae un recibo sin firma: prueba consistencia, no origen.

Puertas: cuál usar

Inicio rápido

URL recomendada: https://bursia-utils-production.up.railway.app/mcp/puerta. Sin autenticación.

Claude

1. claude.ai o Claude Desktop: Configuración → Conectores → Agregar conector personalizado. Nombre Burs-IA, URL de arriba, sin autenticación.
2. Claude Code:

claude mcp add --transport http burs-ia https://bursia-utils-production.up.railway.app/mcp/puerta

ChatGPT (modo desarrollador)

1. Si tu cuenta lo pide, activa el modo desarrollador en la configuración de ChatGPT (depende del plan y de las políticas del espacio de trabajo).
2. En chatgpt.com/plugins: + → Add custom MCP server; nombre y la URL de arriba; Authentication: No authentication.
3. Acepta el aviso y elige Create as a plugin.

Para ChatGPT también existe https://bursia-utils-production.up.railway.app/mcp/chatgpt (sin documentos de identidad).

Grok

1. En grok.com/connectors: New Connector → Custom (la disponibilidad depende del plan y, en Business/Enterprise, de que un administrador lo habilite).
2. Pega la URL de arriba. No hay inicio de sesión que completar (sin autenticación).

Cursor

Botón «Instalar en Cursor» en /puerta, o en ~/.cursor/mcp.json:

{
  "mcpServers": {
    "burs-ia": {
      "url": "https://bursia-utils-production.up.railway.app/mcp/puerta"
    }
  }
}

VS Code

Botón en /puerta, o:

code --add-mcp '{"name":"burs-ia","type":"http","url":"https://bursia-utils-production.up.railway.app/mcp/puerta"}'

o en .vscode/mcp.json:

{
  "servers": {
    "burs-ia": {
      "type": "http",
      "url": "https://bursia-utils-production.up.railway.app/mcp/puerta"
    }
  }
}

Gemini CLI

gemini mcp add --transport http burs-ia https://bursia-utils-production.up.railway.app/mcp/puerta

o en ~/.gemini/settings.json (httpUrl = Streamable HTTP):

{
  "mcpServers": {
    "burs-ia": {
      "httpUrl": "https://bursia-utils-production.up.railway.app/mcp/puerta"
    }
  }
}

HTTP

curl -s -X POST https://bursia-utils-production.up.railway.app/t/co-nit -H 'content-type: application/json' -d '{"nit":"800197268"}'

5 ejemplos

En la puerta: buscar con {"consulta": …} y usar con {"herramienta": …, "argumentos": {…}}. Salidas reales, recortadas con «…».

1. Encontrar la herramienta

buscar {"consulta":"validar NIT colombiano","limite":3}

→ {"resultados":[{"herramienta":"co-nit","titulo":"Dígito de verificación del NIT","grupo":"colombia",…},…]}

2. Dígito de verificación del NIT

usar {"herramienta":"co-nit","argumentos":{"nit":"800197268","dv":"4"}}

→ {"nit":"800197268","dv":4,"valid":true,"formatted":"800.197.268-4"}

3. Días hábiles en Colombia (festivos incluidos)

usar {"herramienta":"co-business-days-add","argumentos":{"date":"2026-12-23","days":3}}

→ {"result":"2026-12-29","weekday":"martes"}

4. Números en letras (cheques, facturas)

usar {"herramienta":"es-number-to-words","argumentos":{"n":1250000}}

→ {"words":"un millón doscientos cincuenta mil"}

5. Leer un Pix copia e cola (solo formato)

usar {"herramienta":"br-pix-brcode","argumentos":{"action":"parse","payload":"00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-4266554400005204000053039865802BR5913Fulano de Tal6008BRASILIA62070503***63041D3D"}}

→ {"valid":true,"crc":{"present":true,"value":"1D3D","computed":"1D3D","ok":true},"kind":"static",…,"key_type":"evp",…,"note":"format check of the text given only; it never confirms, initiates or records a payment / …"}

Errores y pistas

Los errores se corrigen solos: dicen qué falló y traen una llamada correcta para copiar. Nunca repiten tus argumentos.

Límites

• Por cliente: 120 peticiones por minuto, ráfaga 60, 2 llamadas a la vez (valores por defecto).
• Cuerpo hasta 64 KB; hasta 64 niveles; 1000 ms por llamada.
• Lotes JSON-RPC hasta 10 mensajes; cada uno cuenta como una petición.
• buscar: consulta hasta 200 caracteres, hasta 10 resultados. ?tools=a,b filtra tools/list (hasta 40).
• Los resultados son validación de formato, no asesoría; Pix/EMVCo nunca confirman pagos (términos).

Enlaces

• /puerta: instalar con un clic y probar
• /privacidad: qué guardamos
• /terminos: términos de uso
• Registro oficial de MCP: io.github.soyeladice-svg/bursia-utils
• /tools · /openapi.json · /llms.txt · server cards · /stats