Servidor MCP de licitaciones públicas de España

Conecta tu asistente de IA a todas las licitaciones que publica el sector público español. Le preguntas «¿qué licitaciones de limpieza abiertas hay en Madrid por encima de 100.000 €?» y las busca él, con los datos de Don Licitación y el enlace a la publicación oficial. Incluido en la suscripción Pro, con la misma clave que la API.

ChatGPT y Claude, sin clave

El conector público devuelve una muestra de licitaciones y resúmenes de sus fichas, con citas y enlaces para continuar esa misma búsqueda en Don Licitación. No requiere cuenta ni clave de API. Las alertas y el seguimiento se gestionan en la web con una cuenta.

En ChatGPT, activa el modo desarrollador y añade un conector personalizado sin autenticación:

https://donlicitacion.es/conector/chatgpt/mcp

En Claude, añade un conector personalizado en Personalizar, Conectores, sin inicio de sesión:

https://donlicitacion.es/conector/claude/mcp

Ejemplo: «Busca licitaciones de obras en Cádiz con CPV 452 y presupuesto entre 100.000 y 500.000 euros». Las búsquedas admiten texto, CPV, provincia, comunidad autónoma, presupuesto y fechas de publicación. Las fichas completas y sus documentos están en la web.

Acceso completo con Pro

  1. Una cuenta con Pro.
  2. Una clave de API, que se crea en tu panel. Vale una de solo lectura.
  3. Un asistente compatible con MCP que permita añadir una cabecera, como los de abajo.

Dirección del servidor:

https://donlicitacion.es/api/public/v1/mcp

Conectarlo

Sustituye dl_live_TU_CLAVE por tu clave.

Claude Code

claude mcp add --transport http donlicitacion \
  https://donlicitacion.es/api/public/v1/mcp \
  --header "Authorization: Bearer dl_live_TU_CLAVE"

Claude Desktop

En claude_desktop_config.json (Ajustes, Desarrollador, Editar configuración). Necesita Node.js.

{
  "mcpServers": {
    "donlicitacion": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://donlicitacion.es/api/public/v1/mcp",
               "--header", "Authorization:${DL_AUTH}"],
      "env": { "DL_AUTH": "Bearer dl_live_TU_CLAVE" }
    }
  }
}

Cursor

En ~/.cursor/mcp.json:

{
  "mcpServers": {
    "donlicitacion": {
      "url": "https://donlicitacion.es/api/public/v1/mcp",
      "headers": { "Authorization": "Bearer dl_live_TU_CLAVE" }
    }
  }
}

VS Code

En .vscode/mcp.json:

{
  "servers": {
    "donlicitacion": {
      "type": "http",
      "url": "https://donlicitacion.es/api/public/v1/mcp",
      "headers": { "Authorization": "Bearer dl_live_TU_CLAVE" }
    }
  }
}

Otros clientes

Cualquier cliente MCP con transporte HTTP (Streamable HTTP) que permita cabeceras: la clave va en Authorization: Bearer o en X-API-Key. El servidor no mantiene sesión y responde cada petición con JSON. Versiones del protocolo: 2025-06-18, 2025-03-26, 2024-11-05.

Qué puede hacer

Todas las herramientas son de solo lectura: tu asistente consulta, no cambia nada de tu cuenta.

buscar_licitaciones

Busca licitaciones públicas de España, de la más reciente a la más antigua por fecha de publicación. Todos los filtros son opcionales y se combinan. Devuelve hasta limite resultados y un siguiente_cursor para pedir más.

ParámetroTipoPara qué
q texto Texto libre sobre título y objeto. Admite "frase exacta", OR y -excluir.
solo_abiertas sí o no Solo las que admiten ofertas ahora.
provincia texto Por ejemplo, Madrid.
comunidad_autonoma texto Por ejemplo, Cataluña.
cpv texto Código CPV o prefijo (2 dígitos = división).
tipo_contrato texto OBRAS, SERVICIOS, SUMINISTROS...
estado texto OPEN, EVALUATION, AWARDED, FORMALIZED...
procedimiento texto ABIERTO, RESTRINGIDO...
presupuesto_min número Euros sin IVA.
presupuesto_max número Euros sin IVA.
publicada_desde texto AAAA-MM-DD, incluido.
publicada_hasta texto AAAA-MM-DD, excluido.
cursor texto El siguiente_cursor de la respuesta anterior.
limite entero Resultados (por defecto 10).

ver_licitacion

Ficha completa de una licitación: datos, adjudicaciones, documentos y cronología.

ParámetroTipoPara qué
ref (obligatorio) texto id o slug de la licitación.

documentos_licitacion

Pliegos, anuncios y actas publicados para una licitación, con su enlace oficial.

ParámetroTipoPara qué
ref (obligatorio) texto id o slug de la licitación.

ver_organismo

Un órgano de contratación por su NIF o su id: nombre, nivel, ubicación y actividad.

ParámetroTipoPara qué
identificador (obligatorio) texto NIF del organismo o su id.

cambios_desde

Licitaciones cuyo contenido cambió después de since (estado, plazo, adjudicación...), de la más antigua a la más reciente.

ParámetroTipoPara qué
since (obligatorio) texto ISO 8601 con zona, p. ej. 2026-09-24T00:00:00Z.
cursor texto
limite entero Resultados (por defecto 10).

Ideas para preguntar

  • «Busca licitaciones abiertas de mantenimiento de ascensores en Andalucía y ordénalas por plazo.»
  • «Dame los pliegos y anuncios publicados de esta licitación, con sus enlaces.»
  • «¿Qué licitaciones ha publicado el Ayuntamiento de Getafe este año y a quién se adjudicaron?»
  • «¿Qué licitaciones de obras en Madrid han cambiado de estado desde ayer?»

Límites

Los mismos que la API, compartidos con ella: 60 peticiones por minuto y 10.000 al día por clave. Cada mensaje cuenta, también el de conexión. Tu asistente recibe el aviso si se agotan.

Errores

Si falta la clave, está revocada o la cuenta no es Pro, el servidor responde con el mismo código de error que la API (invalid_api_key, revoked_api_key, plan_required…), explicados en la guía de la API. Si una herramienta recibe un argumento que no vale o busca algo que no existe, responde con un mensaje claro para que tu asistente lo corrija.

Tu clave

Quien tenga tu clave consulta con tu cuenta y gasta tu cuota. No la compartas ni la pegues en un chat. Si se filtra, revócala en tu panel y crea otra.

Fuentes y licencias

Cada licitación lleva su fuente con el titular, la licencia y el texto de atribución. Si publicas lo que te devuelva tu asistente, consérvalo. Detalle en la guía de la API.