QuoteBill

npx add-mcp 'https://quotebill.com/mcp'

Servidor MCP de QuoteBill

Redacta presupuestos y facturas desde el asistente de IA que ya utilizas. El servidor MCP remoto de QuoteBill ofrece a ChatGPT, Claude, Gemini y cualquier otro cliente MCP:

• 133 plantillas de presupuestos y facturas para oficios, servicios profesionales, países e idiomas
• Reglas fiscales para 195 países, cada una con la fuente oficial de la que se leyó y la fecha en que se verificó
• Totales calculados con la misma aritmética que el editor de QuoteBill, redondeados a la moneda
• Un enlace al documento terminado: build_document devuelve una URL que abre el presupuesto o la factura redactados, ya cumplimentados, en quotebill.com, listos para descargar como Excel o Word o para guardar como PDF

Endpoint	https://quotebill.com/mcp
Transporte	HTTP transmisible (respuestas JSON)
Autenticación	OAuth 2.1 con una cuenta gratuita de QuoteBill. Tu aplicación de IA encuentra el inicio de sesión por sí sola: abre QuoteBill, inicias sesión (Google funciona) y eliges Permitir
Protocolo	2026-07-28, y las revisiones de protocolo de enlace 2025-03-26 a 2025-11-25
Idiomas	Respuestas en 33 idiomas
Guía para personas	Usar QuoteBill en ChatGPT, Claude y Gemini
Registro MCP	io.github.auto1225/quotebill

Conectar

La primera vez que te conectas, tu aplicación de IA abre QuoteBill en el navegador. Inicia sesión o regístrate gratis, comprueba qué aplicación está solicitando acceso y elige Permitir. Esto se hace una vez por aplicación; puedes desconectar una aplicación en cualquier momento en Aplicaciones de IA conectadas en la configuración de la empresa de QuoteBill.

Claude (claude.ai, escritorio y móvil) — Configuración → Conectores → Añadir conector personalizado. Nombre QuoteBill, URL https://quotebill.com/mcp, luego Conectar. O abre este enlace: añadir QuoteBill a Claude.

ChatGPT (chatgpt.com) — activa el modo desarrollador en Configuración, luego crea una aplicación desde la página de aplicaciones: URL del servidor MCP https://quotebill.com/mcp, autenticación OAuth. Inicia sesión en QuoteBill y permítelo, luego añade QuoteBill desde el menú + en un chat.

Claude Code

claude mcp add --transport http quotebill https://quotebill.com/mcp

Luego ejecuta /mcp, elige quotebill e inicia sesión.

Codex — ~/.codex/config.toml, luego codex mcp login quotebill

[mcp_servers.quotebill]
url = "https://quotebill.com/mcp"

Gemini CLI — instala este repositorio como extensión:

gemini extensions install https://github.com/auto1225/quotebill-mcp

o añádelo a ~/.gemini/settings.json:

{ "mcpServers": { "quotebill": { "httpUrl": "https://quotebill.com/mcp" } } }

Luego ejecuta /mcp auth quotebill una vez para iniciar sesión.

Cursor — .cursor/mcp.json (Cursor abre el inicio de sesión cuando habilitas el servidor)

{ "mcpServers": { "quotebill": { "url": "https://quotebill.com/mcp" } } }

VS Code — .vscode/mcp.json (VS Code te pide iniciar sesión cuando el servidor se inicia)

{ "servers": { "quotebill": { "type": "http", "url": "https://quotebill.com/mcp" } } }

Plugin de Claude Code — este repositorio también es un mercado de plugins:

/plugin marketplace add auto1225/quotebill-mcp
/plugin install quotebill@quotebill

Cómo funciona el inicio de sesión

Una solicitud sin token recibe 401 con WWW-Authenticate: Bearer resource_metadata="https://quotebill.com/.well-known/oauth-protected-resource/mcp". Esos metadatos (RFC 9728) nombran el servidor de autorización, Supabase Auth en https://wgpfbcfiontxqusseoyv.supabase.co/auth/v1, cuyos metadatos (RFC 8414) ofrecen registro dinámico de clientes, PKCE y el alcance email. Los clientes MCP que siguen la especificación de autorización MCP no necesitan nada más.

Herramientas

Herramienta	Qué hace
search_templates	Encuentra plantillas por palabras, tipo de documento o categoría, en el idioma solicitado, con ejemplos de líneas de artículo y la página en la que se abre cada una.
get_template	El registro completo de un slug de plantilla.
get_tax_rule	La tasa publicada, su nombre, la moneda y la fuente de la que se leyó, para cualquiera de los 195 países. Los países sin una tasa nacional única, como Estados Unidos, se informan como que necesitan una jurisdicción en lugar de darles un número inventado.
calculate_totals	Suma las líneas de artículo, aplica descuentos y el impuesto del país, redondeando cada componente fiscal por separado a la moneda.
build_document	Construye un presupuesto o factura completo, lo totaliza y devuelve un enlace que lo abre cumplimentado. language es el idioma del documento; interfaceLanguage el idioma en que se abre la página.
list_guides	Las guías prácticas de QuoteBill, como convertir un presupuesto en factura o qué debe contener una factura alemana, japonesa o coreana.
list_reference	Las categorías, diseños, idiomas y códigos de país que aceptan las demás herramientas.

Cada herramienta publica un inputSchema y un outputSchema, y está anotada readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false. Los argumentos no válidos se devuelven como un error de herramienta que indica qué corregir.

Ejemplos de solicitudes

• "Haz una factura en QuoteBill para mi cliente en Japón: diseño web ¥480.000, más tres meses de mantenimiento a ¥25.000 al mes, con un 5% de descuento en el mantenimiento."
• "Usa QuoteBill para hacer un presupuesto de 12 horas de consultoría a 95 € la hora para un cliente en Alemania."
• "Encuentra una plantilla de QuoteBill para un presupuesto de fontanería y complétala con estos trabajos."
• "¿Cuál es la tasa de IVA en Francia y de dónde la obtiene QuoteBill?"

Privacidad

El servidor comprueba que quien llama es un miembro de QuoteBill con sesión iniciada, y luego solo consulta plantillas y reglas fiscales y hace aritmética. El token de inicio de sesión que tiene una aplicación de IA no puede leer los documentos guardados, el perfil ni los archivos del miembro; la base de datos rechaza todo token emitido a una aplicación. El servidor no guarda nada y no conserva nombres de clientes ni importes; su registro anota la herramienta, si respondió y el nombre del cliente, nunca los argumentos ni la cuenta. Un documento redactado viaja dentro del enlace devuelto, después del #, que los navegadores nunca envían a un servidor, y el enlace lleva una suma de verificación para que una copia alterada se rechace en lugar de abrirse con una cifra incorrecta. Las llamadas tienen límite de frecuencia por cuenta mediante un hash con sal que cambia cada minuto; esos recuentos se eliminan en menos de una hora. Consulta el aviso de privacidad.

Límites

• 60 llamadas de herramienta por minuto por cuenta
• Hasta 200 líneas de artículo e importes de hasta 100.000.000.000 por línea y por documento
• Una tasa fiscal publicada es un punto de partida, no asesoramiento fiscal: el registro, el lugar de suministro y el tratamiento de los bienes o servicios aún deben confirmarse

Soporte

auto0104@gmail.com · quotebill.com/en/contact

Licencia

Los archivos de configuración de este repositorio tienen licencia MIT. El servicio QuoteBill se opera en quotebill.com.