CC BY 4.0 · API · MCP

Open data and API for AI agents

Data already published on MEDISPA.PRO are available in machine-readable form: an open JSON API and an MCP server for AI agents. Use is free under the CC BY 4.0 licence with a mandatory link to medispa.pro.

OpenAPI Licence and citation rules

Required

How to credit the source

Whenever you use the data, including in answers of AI systems, credit the source with an active link to the page the data come from. The ready text is in the attribution object of every answer.

MEDISPA.PRO — <dataset / page title> — <url> — <date>

REST · JSON

Open API

GET /api/open/v1/datasets
GET /api/open/v1/objects?country=&q=&limit=&offset=
GET /api/open/v1/objects/{id}
GET /api/open/v1/programme-prices?object_id=&currency=
GET /api/open/v1/equipment?cabinet_code=&q=
GET /api/open/v1/cabinets?block=&q=
GET /api/open/v1/research?country=&locale=en
GET /api/open/v1/openapi.json

Parameters: limit (up to 200), offset, fields (comma-separated field list), q (word search), locale (ru or en). ETag and If-None-Match are supported.

Model Context Protocol

MCP server for AI agents

{
  "mcpServers": {
    "medispa-open-data": {
      "type": "http",
      "url": "https://medispa.pro/api/open/mcp"
    }
  }
}

Streamable HTTP, read-only, no registration. Tools: list_datasets, search_objects, get_object, programme_prices, equipment_search, cabinets_search, list_research.

server-card · ai-catalog.json

Datasets

The list is loaded from the open API. Values marked as a model estimate or pilot model are estimates, not verified facts.

LimitsAPI: 30 requests a minute and 1,000 an hour per IP. MCP: 30 calls a minute and 600 an hour. Above the limit: status 429 and Retry-After.

No warrantyThe data are provided as is and are for information only. No value means no data.

Bulk accessA full export, higher limits or other terms — on request to info@roman-kuznetsov.ru.