# tok

> tok is an open-source MCP server for developer tools. MCP server for writing, checking and converting BPMN and DMN models in tok text. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://tok-lang-bpm.github.io
- **Repository:** https://github.com/tok-lang-bpm/tok
- **MCP Registry name:** io.github.tok-lang-bpm/tok
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

tok is a plain-text language for process models, and this MCP server gives an AI agent the same engine the command-line tool uses. A .tok file describes a BPMN 2.0 process (pools, lanes, events, tasks, gateways, flows and data) along with the DMN decisions, forms and simulation parameters that go with it.

Through the server an agent can check a model against BPMN 2.0.2 rules, export it to BPMN XML with an automatically computed layout, SVG, DMN files or Camunda 8 forms, import existing BPMN and DMN files back into text, simulate a process and evaluate decisions. Because every interface runs the same Rust engine, diagnostics and exports match what you get from the CLI, Python, R, Julia, WebAssembly or the language server.

It installs from PyPI as tok-lang and runs over stdio. The project's own guide also covers an agent bundle with modelling skills, and a GitHub Action for checking models in continuous integration. It suits analysts, students and developers who want process models that can be diffed and reviewed as text.

## Features

- **Check models:** Validates a tok model against BPMN 2.0.2 rules and returns diagnostics.
- **Export:** Produces BPMN XML with computed layout, SVG, DMN files and Camunda 8 forms.
- **Import:** Converts existing BPMN and DMN files back into tok text.
- **Simulate and evaluate:** Runs process simulations and evaluates DMN decisions.
- **One shared engine:** The Rust engine behind the CLI, language bindings and this server gives identical results.

## Good for

- Let an agent draft a BPMN process from a description
- Validate process models in review
- Convert a BPMN file to readable text for diffing
- Generate Camunda 8 forms from a model
- Teach BPMN with a notation that can be checked line by line

## Install

### Claude Code (Terminal)

```sh
claude mcp add tok -- uvx tok-lang
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tok": {
      "command": "uvx",
      "args": [
        "tok-lang"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tok": {
      "command": "uvx",
      "args": [
        "tok-lang"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tok": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tok-lang"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tok": {
      "command": "uvx",
      "args": [
        "tok-lang"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tok": {
      "command": "uvx",
      "args": [
        "tok-lang"
      ]
    }
  }
}
```

## Tools

- `check`: Check a model.
- `export`: Export a model.
- `import`: Import BPMN or DMN.
- `simulate`: Simulate a process.
- `evaluate`: Evaluate a decision.

## FAQ

### How do I install it?

Install the tok-lang package from PyPI; the server uses stdio transport.

### Does it replace Camunda Modeler?

No. Its BPMN output opens in Camunda Modeler and bpmn.io like any other BPMN file.

### Is coordinate layout stored in the model?

No. The text contains no coordinates; the diagram layout is computed whenever it is needed.

### What else can use the same engine?

The command line, Python, R, Julia, C programs, WebAssembly in a web page and editors via a language server.

### Is tok free?

Yes. tok is open source, so you can use and self-host it for free.

### How do I add tok to Claude Code?

Run this command in your terminal: claude mcp add tok -- uvx tok-lang

### What are the best alternatives to tok?

The closest alternatives to tok are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/tok
