Model Context Protocol (MCP)

The Jonas Event Technology API exposes event reporting data via the Model Context Protocol, enabling AI assistants to query event data, run reports, and export datasets.

Connection

Setting	Value
Transport	Streamable HTTP (with legacy SSE backward compatibility)
Endpoint	`https://api.beta.eventdata.uk/mcp`
Legacy SSE	`https://api.beta.eventdata.uk/mcp/sse`
Authentication	OAuth 2.0 Bearer Token (scope: `reporting:read`)

Claude Desktop Configuration

{
  "mcpServers": {
    "jet-reporting": {
      "url": "https://api.eventdata.uk/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Authentication: Obtain a Bearer token via POST /connect/token using client_id=eventdata-api with the OAuth password flow and the reporting:read scope. See the API Documentation for details.

Tools

Four tools are available for querying event data:

`list_events`

List available events. Returns event references, names, and dates. Use this first to find which events are available for reporting.

No parameters required.

`list_reports`

Discover available reports and their parameters. Returns report IDs, titles, descriptions, and parameter requirements.

Parameter	Type	Required	Description
`category`	string	optional	Filter by category (e.g., Attendance, General, Geographic, Exhibitor, Periodic)

`run_report`

Execute a report and return the results as a formatted markdown table. Requires an event reference and report ID.

Parameter	Type	Required	Description
`reportId`	string	required	Report ID (e.g., `category`, `attendance/live`, `geographic/country`)
`eventRef`	string	required	Event reference (e.g., `FCE26`, `AAAA4`)
`parameters`	string	optional	JSON string of additional parameters (e.g., `{"dayNo": 1}`)
`page`	int	optional	Page number (1-based, default: 1)
`pageSize`	int	optional	Page size (default: 100, max: 1000)

`export_data`

Export a report's complete dataset as CSV or JSONL. Returns all rows without pagination. Use this for raw data analysis or when the report has too many rows for the markdown table format.

Parameter	Type	Required	Description
`reportId`	string	required	Report ID
`eventRef`	string	required	Event reference
`format`	string	optional	`csv` (default) or `jsonl`

Prompts

Three guided prompts help AI assistants work effectively with event data:

`get_started`

Introduction to Jonas Event Technology reporting. Explains available tools, lists report categories, and suggests starter questions.

No parameters required.

`explore_event`

Guide for exploring a specific event's data. Suggests which reports to run and in what order for a comprehensive overview.

Parameter	Type	Required	Description
`eventRef`	string	required	The event reference to explore (e.g., `FCE26`)

`analyse_report`

Analyse a specific report's data. Runs the report, then summarises findings, identifies trends, and suggests visualisations.

Parameter	Type	Required	Description
`reportId`	string	required	The report ID to analyse
`eventRef`	string	required	The event reference

Workflow

Authenticate via POST /connect/token with client_id=eventdata-api and scope=openid reporting:read offline_access
Connect your MCP client to https://api.beta.eventdata.uk/mcp with the Bearer token
Call list_events to discover available events
Call list_reports to see what reports can be run
Call run_report with an event reference and report ID
Use export_data for large datasets or raw data analysis

Access Control

Reporting access is restricted to authorised users. InternalStaff can access all events. Organisers can only access events assigned to them. Users outside these groups will receive a 403 Forbidden response.