Reference
MAiDATA MCP exposes two tools. Both are read-only: no tool can create, modify or delete data in MAiDATA or in any connected system. Both tools are annotated with readOnlyHint: true.
Tool | Title | Type | Purpose |
| Create MAiDATA session | Read-only | Creates a session identifier that groups related questions in one conversation |
| Query MAiDATA | Read-only | Answers a natural-language data question from the MAiDATA datasets |
Both tools require an authenticated MAiDATA user (OAuth 2.0).
create_maidata_session
Creates a new analytical session and returns a session identifier. The AI assistant passes this identifier with subsequent query_maidata calls so that related questions within one conversation are grouped together.
Input: none.
Output: a session identifier.
query_maidata
Accepts a natural-language question, selects the appropriate dataset, generates a read-only SQL query, runs it against the MAiDATA data warehouse and returns the results.
Input
Parameter | Description |
| The data question in plain language, for example “Package counts and reimbursement for rivaroxaban by brand for 2023–2025.” |
| The dataset family to query: reimbursed medicinal products (LP), distribution and eRecept flows (DLE) or medical devices (ZP). See Data sources. |
| Optional. The identifier returned by |
Output
The result table in JSON format, containing records or values derived from the MAiDATA datasets through selection, transformation or aggregation.
The generated SQL statement, so users can review how the result was produced.
Source metadata: the source table, publishing institution, release date and a link to the official open-data catalogue entry.
Limits
Limit | Value |
Rows returned in the first result page | 1,000 |
Maximum question length | 16,384 characters |
For larger results, ask for aggregated data (for example totals by year, brand or region) or split the question by period or segment.
What the tools cannot do
Write, update or delete any data.
Access files, documents, e-mails, conversations or other content in the AI assistant or workspace.
Return content that cannot be derived from the MAiDATA datasets through a read-only SQL query.
Getting started
Connect your assistant
Reference
Security and privacy
