API y servidor MCP

Una API es una puerta para programas: en lugar de una página para leer, tu programa pide una dirección web y recibe los datos ordenados en formato JSON, listos para guardarlos en una hoja de cálculo o cruzarlos con otros. Sirve, por ejemplo, para vigilar cada día los contratos de una consejería o montar tu propio análisis.

Un servidor MCP hace lo mismo para asistentes de inteligencia artificial como Claude. MCP (Model Context Protocol) es el idioma común con el que esos asistentes consultan fuentes externas. Lo conectas una vez y puedes preguntarle en lenguaje normal, por ejemplo: «¿qué contratos de limpieza adjudicó Educación en 2025 y a quién?». El asistente buscará aquí y te dará las direcciones de las fichas para que lo compruebes.

Las dos son de solo lectura y muestran exactamente lo que muestra la web. Si lo que quieres es la base de datos entera de una vez, tienes los datos abiertos en CSV.

Cada persona usa su propia clave, una contraseña larga que empieza por cmk_. Es gratis, no hay que pedir permiso y se consigue en el bot de Telegram @ContratosMelillaBot, el mismo de las alertas. No hace falta suscribirse a las alertas.

• Los comandos solo funcionan en un chat privado con el bot, nunca en un grupo: en un grupo la clave la leería todo el mundo.
• Como mucho 5 claves nuevas por hora en cada chat.
• La clave se muestra una sola vez. Guárdala en un lugar seguro y no la compartas. Si se te escapa, /clave_nueva la sustituye.

Cada clave puede hacer 60 peticiones por minuto, sumando las de la API y las del servidor MCP: es un solo contador por clave. Si te pasas, la respuesta es un error 429 con la cabecera Retry-After, que dice cuántos segundos esperar. Cada respuesta correcta trae X-RateLimit-Remaining con las peticiones que te quedan en ese minuto.

Para frenar a quien prueba claves al azar, una misma conexión que falla la clave 30 veces queda bloqueada hasta que pasa un minuto desde el primer fallo.

Todas usan el método GET y llevan la clave en la cabecera Authorization: Bearer cmk_… (cambia cmk_… por tu clave). En los ejemplos se usa curl, un programa de la terminal; cualquier lenguaje sirve. Donde pone {slug}, pon el último tramo de la url de la ficha: para https://contratosmelilla.es/contrato/abc sería abc.

La descripción técnica completa, en formato OpenAPI, está en /api/v1/openapi.json (no necesita clave). Muchas herramientas la leen directamente.

curl -H "Authorization: Bearer cmk_…" "https://contratosmelilla.es/api/v1/contratos?query=limpieza&anio=2025&tipo=menor&limit=5"

curl -H "Authorization: Bearer cmk_…" "https://contratosmelilla.es/api/v1/contratos/{slug}"

curl -H "Authorization: Bearer cmk_…" "https://contratosmelilla.es/api/v1/empresas/{slug}?page=1"

curl -H "Authorization: Bearer cmk_…" "https://contratosmelilla.es/api/v1/organos/{slug}?page=1"

curl -H "Authorization: Bearer cmk_…" "https://contratosmelilla.es/api/v1/novedades?limit=10"

/api/v1/contratos admite los mismos filtros que el buscador. Todos son opcionales y se combinan entre sí. A diferencia de la web, un parámetro desconocido, repetido o mal escrito no se ignora: devuelve un error 400 que dice cuál es, para que sepas que tu búsqueda no era la que pediste. Un DNI/NIE en cualquier parámetro devuelve un error 400.

La respuesta trae data (los contratos) y paginacion (página, resultados por página, total y número de páginas).

Un error siempre tiene la misma forma, con un código fijo y un mensaje en español:

{ "error": { "code": "VALIDATION", "message": "Parámetro no válido: anio." } }

Cada contrato, empresa, órgano o novedad lleva un campo url con su dirección en esta web. Úsalo para citar la fuente y para que tus lectores lo comprueben. Si publicas algo hecho con estos datos, cita ContratosMelilla.es con ese enlace. Las fichas de contrato traen además enlaceOficial, el enlace a la publicación oficial.

La dirección del servidor es:

https://contratosmelilla.es/mcp

Usa la misma clave y el mismo límite que la API. Tu asistente verá estas herramientas, cada una equivalente a una consulta de la API:

• buscar_contratosBuscar contratos
• ver_contratoVer un contrato
• ver_empresaVer una empresa
• ver_organoVer un órgano de contratación
• novedadesNovedades

Claude Code

Escribe en la terminal (con tu clave en lugar de cmk_…):

claude mcp add --transport http contratosmelilla https://contratosmelilla.es/mcp --header "Authorization: Bearer cmk_…"

Claude Desktop y otros asistentes

Los conectores remotos de Claude Desktop y de claude.ai se identifican con OAuth, un sistema de inicio de sesión que este servidor no usa: aquí basta la clave. Para usarlo desde un programa instalado en tu ordenador hace falta un pequeño puente, mcp-remote, que necesita Node.js y añade la clave a cada petición:

npx mcp-remote https://contratosmelilla.es/mcp --header "Authorization: Bearer ${CLAVE}"

En Claude Desktop se configura en su archivo de configuración, dentro de mcpServers:

{
  "mcpServers": {
    "contratosmelilla": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://contratosmelilla.es/mcp",
        "--header",
        "Authorization: Bearer ${CLAVE}"
      ],
      "env": {
        "CLAVE": "cmk_…"
      }
    }
  }
}

En Windows, si el puente no conecta, prueba a escribir la cabecera sin espacios (Authorization:${CABECERA}, con CABECERA = "Bearer cmk_…" en env), como explican las instrucciones de mcp-remote. La versión web de claude.ai no puede ejecutar este puente.

Son datos de contratos del sector público. La API y el servidor MCP muestran exactamente lo mismo que la web, con la misma protección: el DNI/NIE de las personas físicas (autónomos, por ejemplo) aparece enmascarados igual que en sus fichas. Los CIF de empresas son públicos y se muestran completos.

No hay otra forma de obtener datos sin enmascarar: ni la clave, ni un parámetro, ni el servidor MCP dan acceso a más de lo que muestra la web. No escribas DNI/NIE en las búsquedas: se rechazan, y la dirección de una petición puede quedar guardada en registros técnicos.

Qué guardamos de tu clave y para qué lo cuenta la política de privacidad.