pretalx-mcp (local-only)

pretalx-mcp is a local MCP server for pretalx. It is designed to run as a child process of a local MCP client and communicates over stdio only.

Local MCP client -> local stdio MCP process -> outbound HTTPS -> pretalx API

Only outbound HTTPS requests to pretalx are expected. No inbound network service is exposed.

Features

• Local-only architecture (no hosted or remote MCP endpoint).

• stdio is the only supported transport.

• Read-only by default (PRETALX_READ_ONLY=true).

• Environment-based configuration via .env.

• MCP tools for events, submissions, speakers, schedule, and optional reviews.

Related MCP server: mcp-model-proxy

Installation

1. Install Python 3.11+ and uv.

2. Clone this repository.

3. Sync dependencies:

uv sync

Configuration

Copy .env.example to .env and fill in local values:

cp .env.example .env

Running locally

Run the server locally with stdio transport:

uv run pretalx-mcp

This process is intended to be launched by an MCP client, not exposed as a web service.

MCP client configuration

See docs/MCP_CLIENT_SETUP.md for a generic MCP client JSON configuration using:

uv --directory /path/to/pretalx-mcp run pretalx-mcp

Security notes

• Keep API tokens local and out of git history.

• Prefer least-privilege, read-only pretalx tokens.

• Never log or print tokens.

• Do not run this project as a hosted/cloud MCP service.

See docs/SECURITY.md for full guidance.

Development

Common local commands:

uv sync
uv run ruff check .
uv run pytest

Project docs and metadata files:

• .env.example

• .gitignore

• docs/SECURITY.md

• docs/MCP_CLIENT_SETUP.md

Roadmap

• Deliver read-only organiser workflows first.

• Keep transport local (stdio) and avoid any remote server mode.

• Add optional review-oriented tools where API permissions allow.

• Consider future write tools only behind explicit safety checks and opt-in configuration.