Predictika Validator MCP

An MCP (Model Context Protocol) server for validating Predictika models and launching Predictika Validator/Configurator servers on the Predictika platform.

Note: the MCP server itself runs locally (or wherever you host it), but the validator/configurator servers it launches and deletes are remote -- they are provisioned on and torn down from Predictika's own infrastructure, not on the machine running this MCP server.

Installation

uv tool install pdtk-val-mcp

Configuration

The server uses the following environment variables.

Required

Example:

export PREDICTIKA_API_KEY=<your-api-key>
export PREDICTIKA_API_BASE_URL=<your-validator-base-url>

Optional

MCP Client Setup

Claude Code

claude mcp add predictika-validator \
  --env PREDICTIKA_API_KEY="$PREDICTIKA_API_KEY" \
  --env PREDICTIKA_API_BASE_URL="$PREDICTIKA_API_BASE_URL" \
  -- predictika-validator-mcp

Codex CLI

codex mcp add predictika-validator \
  --env PREDICTIKA_API_KEY="$PREDICTIKA_API_KEY" \
  --env PREDICTIKA_API_BASE_URL="$PREDICTIKA_API_BASE_URL" \
  -- predictika-validator-mcp

Updating

To upgrade to the latest released version:

uv tool upgrade pdtk-val-mcp

Tools

The server exposes the following MCP tools:

• validate_model — Validates a Predictika model.
• launch_validator — Creates a remote Predictika Validator/Configurator server for a Predictika project on Predictika's infrastructure: uploads the model files, then starts the server.
• validate_choices — Validates a set of user choices against a running Predictika Validator/Configurator session.
• reset_session — Resets a running Predictika Validator/Configurator session.
• list_validators — Lists remote validator servers (all_users=true for everyone, default only the current user), with name, project, status and owner.
• start_validator — Starts an already-created remote validator server. Uploads nothing.
• stop_validator — Shuts down a remote validator server but keeps it and its files, so it can be started again.
• delete_validator — Stops a remote validator server and removes all files associated with it. Destructive and not reversible.

Lifecycle: launch / start / stop / delete

Use launch_validator the first time (or to deploy a changed model), stop_validator/start_validator to pause and resume an existing server, and delete_validator only when the server is no longer needed.