Metadata-Version: 2.4
Name: pdtk-cfg-mcp
Version: 0.1.0
Summary: MCP server for Predictika Configurator
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.10
Requires-Dist: requests>=2.31
Requires-Dist: pyyaml>=6.0

# Predictika Configurator MCP

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

## Installation

Install the server using one of the following methods.

### pipx (Recommended)

```bash
pipx install predictika-configurator-mcp
```

### uv

```bash
uv tool install predictika-configurator-mcp
```

## Configuration

The server uses the following environment variables.

### Required

| Variable             | Description                                 |
| -------------------- | ------------------------------------------- |
| `PREDICTIKA_API_KEY` | Predictika API key used for authentication. |

Example:

```bash
export PREDICTIKA_API_KEY=<your-api-key>
```

### Optional

| Variable                   | Default                                    | Description                                 |
| -------------------------- | ------------------------------------------ | ------------------------------------------- |
| `PREDICTIKA_API_BASE_URL`  | `https://partner.predictika.com/validator` | Override the Predictika validator endpoint. |
| `PREDICTIKA_MCP_LOG_FILE`  | Logging disabled                           | Write server logs to the specified file.    |
| `PREDICTIKA_MCP_LOG_LEVEL` | `INFO`                                     | Logging level.                              |

## MCP Client Setup

### Claude Code

```bash
claude mcp add predictika-configurator \
  --env PREDICTIKA_API_KEY="$PREDICTIKA_API_KEY" \
  -- predictika-configurator-mcp
```

### Codex CLI

```bash
codex mcp add predictika-configurator \
  --env PREDICTIKA_API_KEY="$PREDICTIKA_API_KEY" \
  -- predictika-configurator-mcp
```

If you are using a custom Predictika server, also pass `PREDICTIKA_API_BASE_URL` when adding the MCP server.

## Updating

To upgrade to the latest released version:

### pipx

```bash
pipx upgrade predictika-configurator-mcp
```

### uv

```bash
uv tool upgrade predictika-configurator-mcp
```

## Tools

The server exposes the following MCP tools:

* `validate_predictika_model` — Validates a Predictika model.
* `launch_predictika_configurator` — Launches a Predictika Configurator server for a Predictika project.
