qlows MCP - Tender Search & RFP Response

Encuentra licitaciones públicas en 35 países (zona OMC-ACP) y fundamenta tu IA al responder a solicitudes de propuestas (RFPs).

GitHub

Documentación

Conector qlows MCP

Lleva tus acuerdos RFP/licitación en vivo de qlows — y el corpus público de licitaciones en 35 países del Acuerdo de Contratación Pública de la OMC — a Claude, Cursor, Windsurf, Cline, Zed, o cualquier cliente del Model Context Protocol.

qlows-mcp es un conector local diminuto. Se ejecuta en tu máquina como un servidor MCP stdio y actúa como proxy seguro de las llamadas de herramientas hacia la API de qlows (https://app.qlows.com). No almacena nada más que tu token, no contiene lógica de backend, y es de solo lectura — tu IA puede obtener contexto de acuerdos, nunca escribir de vuelta.

Cotizaciones. Flujos. Cierres. qlows prepara la oferta; tu IA redacta a partir de contexto real y fundamentado. Aprende más en https://qlows.com.

Instalación

Instalación con un clic para los clientes comunes (o copia el fragmento JSON a continuación):

Inicio rápido (≈ 1 minuto)

# 1. Connect your account (opens the browser, you paste a token back)
npx @qlows/mcp login

# 2. Verify it works
npx @qlows/mcp test          # → prints the available tools

# 3. Print the snippet for your AI client
npx @qlows/mcp config

Luego agrega qlows a tu cliente (ejemplo: Claude Desktop, ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "qlows": {
      "command": "npx",
      "args": ["-y", "@qlows/mcp"]
    }
  }
}

Reinicia el cliente. Si no ejecutaste login, pasa el token en su lugar:

{
  "mcpServers": {
    "qlows": {
      "command": "npx",
      "args": ["-y", "@qlows/mcp"],
      "env": { "QLOWS_TOKEN": "qlw_live_…" }
    }
  }
}

Necesitarás una cuenta de qlows para generar un token personal (el plan gratuito funciona para búsqueda de licitaciones). Regístrate y genera el token en https://app.qlows.com/mcp.

Prueba estos mensajes

Después de conectar, pregúntale a tu IA:

"Usa el MCP de qlows para listar mis acuerdos abiertos y luego resume los 3 riesgos principales en el más urgente."
"Busca licitaciones públicas de redes Zero-Trust en la UE que cierren en los próximos 30 días, y dame el enlace de qlows para cada una."
"Lee el acuerdo <deal-id> de qlows y redacta la sección de Enfoque Técnico, fundamentando cada afirmación en los elementos de cumplimiento y nuestras respuestas aprobadas."

Lo que obtienes

Todas las herramientas son de solo lectura. Las herramientas de datos personales necesitan un token personal; las herramientas de licitaciones también funcionan con una cuenta gratuita.

Herramienta	Qué hace
`list_deals`	Tus acuerdos RFP/licitación (metadatos ligeros)
`get_deal_snapshot`	Instantánea completa del acuerdo — resumen RFP + cumplimiento + enrutamiento de preguntas + inteligencia
`search_compliance_items`	Búsqueda por palabras clave en elementos de cumplimiento
`get_q_routing_state`	Secciones + preguntas + respuestas + estado de asignación
`get_intelligence_summary`	Resumen de IA + detección de personalización
`list_questions`	Lista plana de preguntas
`list_competitors`	Análisis de competidores por acuerdo
`search_tenders`	Búsqueda en el corpus público de licitaciones (FTS + filtros)
`search_tenders_for_my_company`	Búsqueda semántica personalizada de licitaciones
`get_tender_detail`	Registro completo enriquecido para una licitación

Además, tres prompts (comandos de barra) — find_matching_tenders, draft_rfp_section, weekly_pipeline_review — consulta Habilidades a continuación.

El conector descubre herramientas y prompts en vivo desde el servidor, por lo que las nuevas capacidades de qlows aparecen sin actualizar este paquete.

Habilidades

Tres cosas para las que qlows está diseñado dentro de tu IA. Cada una se asigna a un prompt (un comando de barra que tu cliente expone) más las herramientas de solo lectura que impulsa — todo fundamentado en datos reales de qlows, nunca inventado.

🔎 Encuentra licitaciones coincidentes

Prompt: find_matching_tenders (argumentos: industry, opcional country, opcional deadline_within_days). Impulsa search_tenders y devuelve cada aviso en vivo con su qlows_url canónico. Contexto completo: https://qlows.com/platform/qlows-mcp.

"Encuentra licitaciones abiertas de redes zero-trust en Alemania que cierren en los próximos 30 días, con el enlace de qlows para cada una."

✍️ Redacta una sección de RFP, fundamentada

Prompt: draft_rfp_section (argumentos: deal_id, section). Obtiene la cuadrícula de cumplimiento del acuerdo y las respuestas aprobadas mediante get_deal_snapshot + search_compliance_items, luego redacta la sección con cada afirmación rastreada hasta su fuente — sin capacidades, fechas o desempeño pasado fabricados.

"Redacta el Enfoque Técnico para el acuerdo <id>, fundamentado en los elementos de cumplimiento y nuestras respuestas aprobadas."

🗂️ Revisa tu cartera

Prompt: weekly_pipeline_review (sin argumentos). Usa list_deals + get_q_routing_state para producir una lista de tareas priorizada: qué vence, qué está bloqueado y la siguiente acción por acuerdo.

"Revisa mi cartera de qlows y dime qué ofertas necesitan atención primero."

Las habilidades de licitaciones públicas funcionan con una cuenta gratuita; las habilidades de acuerdos necesitan un token personal. Consulta la descripción general completa de la plataforma.

Comandos

Comando	Descripción
`qlows-mcp`	Ejecuta el servidor MCP sobre stdio (cómo lo lanzan los clientes)
`qlows-mcp login`	Inicia sesión mediante navegador y almacena un token en `~/.qlows/config.json` (0600)
`qlows-mcp test`	Lista las herramientas disponibles para verificar tu token
`qlows-mcp config`	Muestra la ruta de configuración + un fragmento de configuración del cliente
`qlows-mcp help`	Uso

Variables de entorno

QLOWS_TOKEN — Token de API (anula el almacenado).
QLOWS_BASE_URL — por defecto es https://app.qlows.com; apunta a http://localhost:3000 para pruebas locales.

Cómo funciona

MCP client (Claude/Cursor)  ⇄  qlows-mcp (stdio, local)  ⇄  https://app.qlows.com/api/mcp/<token>/rpc

El conector es un proxy JSON-RPC transparente. No implementa herramientas — reenvía initialize, tools/list, tools/call, prompts/* y resources/* al servidor de qlows y retransmite las respuestas. El token viaja en la solicitud a qlows a través de HTTPS; trátalo como una contraseña.

Solución de problemas

No qlows token found — ejecuta qlows-mcp login, o establece QLOWS_TOKEN.
Token missing, invalid, or expired — el token fue revocado o expiró; genera uno nuevo en https://app.qlows.com/mcp y vuelve a ejecutar login.
Rate limit exceeded — 60 solicitudes/min por token; espera y reintenta.
El cliente no ve qlows — reinicia el cliente después de editar la configuración; valida el JSON (una coma suelta lo rompe silenciosamente); revisa los registros MCP del cliente.

Verifica de extremo a extremo con el Inspector MCP:

npx @modelcontextprotocol/inspector npx @qlows/mcp

Privacidad y seguridad

Solo lectura: ninguna herramienta escribe de vuelta a tu cuenta de qlows.
El conector almacena solo tu token, localmente, en ~/.qlows/config.json (permisos 0600). No recopila telemetría.
Los tokens se almacenan con hash SHA-256 en reposo en el servidor de qlows y pueden revocarse al instante en https://app.qlows.com/mcp.
Política de privacidad: https://qlows.com/privacy

Hoja de ruta

Captura automática de navegador con un clic para login (devolución de llamada de bucle local).
Extensión de escritorio (.mcpb) para una instalación verdaderamente de un clic en Claude Desktop (la insignia anterior enlaza a la documentación de configuración mientras tanto).
Listado en el Directorio de Conectores de Anthropic — el endpoint OAuth 2.1 + PKCE está activo en el servidor de qlows; el envío al directorio se rastrea como seguimiento.

Desarrollo

npm install
npm run build
QLOWS_TOKEN=… QLOWS_BASE_URL=http://localhost:3000 node dist/index.js test

La publicación está automatizada en etiquetas v* (consulta .github/workflows/release.yml): npm publish → publicación en el Registro MCP mediante GitHub OIDC.

##Insignias

Licencia

MIT