@pipeworx/aemps-cima

AEMPS CIMA — the Spanish Agency for Medicines and Health Products' public register of every medicine authorised for sale in Spain: brand/generic search, full authorisation detail, the structured ficha técnica (SmPC) and prospecto (patient leaflet) text, current supply shortages, and a changes-since-date feed.

Part of Pipeworx — an MCP gateway connecting AI agents to 1861+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Scope — Spain, and only Spain

Field values are Spanish (paracetamol, ibuprofeno, not US brand names). For the equivalent EU-wide register use ema-medicines; for the UK use mhra-uk; for the US use openfda. Tools are prefixed cima_ so they never win a generic drug question.

Tools

Auth

Keyless. No registration.

Data sources

• https://cima.aemps.es/cima/rest/medicamentos — search.
• https://cima.aemps.es/cima/rest/medicamento — detail by nregistro.
• https://cima.aemps.es/cima/rest/docSegmentado/contenido/{1|2} — segmented ficha técnica (1) / prospecto (2) text by nregistro.
• https://cima.aemps.es/cima/rest/psuministro — supply problems.
• https://cima.aemps.es/cima/rest/registroCambios — changes-since-date feed.

Things the next person would otherwise rediscover

• An unrecognised query parameter on /medicamentos is silently ignored, not rejected — you get the entire ~25,500-row register back, paginated, totalFilas unchanged. Measured: ?xxx=1 → totalFilas: 25455, identical to no filter. This pack only ever sends the confirmed filter set (nombre, practiv1, atc, laboratorio).
• /psuministro silently ignores laboratorio even though it's a field name on the response objects — ?laboratorio=Teva returns the same totalFilas (866) as no filter at all. Only nombre actually filters this endpoint.
• /registroCambios REQUIRES fecha, and rejects its absence with an HTTP 200 — {"error":"Es necesario indicar la fecha"}, not an HTTP error. A caller that only checks status code reads this as a clean empty success. fecha is dd/MM/yyyy, not ISO; an ISO date matches nothing. This pack accepts ISO from the caller and converts.
• Timestamps (estado.aut, estado.rev, fini, ffin, fecha) are epoch MILLISECONDS, converted to YYYY-MM-DD on the way out.
• The ficha técnica can run 25-30 sections. cima_medicine_document_sections caps total output around 40,000 characters (each section further capped ~4,000) and flags truncated: true per section rather than silently dropping content — pass seccion (e.g. "4.1") for one section only when you know which you need.
• Field values stay in AEMPS's own Spanish wording (labtitular, cpresc, comerc...) since that's what a Spanish-market query needs to match against; the pack adds English key names alongside the Spanish content rather than translating it.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "aemps-cima": {
      "url": "https://gateway.pipeworx.io/aemps-cima/mcp"
    }
  }
}

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/aemps-cima/mcp returns the tools in the table above **plus the shared

... View full README on GitHub