MAiDATA

Reference

Supported tools

Supported tools

Supported tools

The tools MAiDATA MCP exposes, their inputs and outputs.

The tools MAiDATA MCP exposes, their inputs and outputs.

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

Create MAiDATA session

Read-only

Creates a session identifier that groups related questions in one conversation

query_maidata

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

text

The data question in plain language, for example “Package counts and reimbursement for rivaroxaban by brand for 2023–2025.”

dataset

The dataset family to query: reimbursed medicinal products (LP), distribution and eRecept flows (DLE) or medical devices (ZP). See Data sources.

session_id

Optional. The identifier returned by create_maidata_session.

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.