Skip to content
MCP server

tok

MCP server for writing, checking and converting BPMN and DMN models in tok text

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.0.3
Listing updated
3 days ago

About tok

tok is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add tok -- uvx tok-lang

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tok": {
      "command": "uvx",
      "args": [
        "tok-lang"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tok": {
      "command": "uvx",
      "args": [
        "tok-lang"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Prices change. Check tok-lang-bpm.github.io before you buy.

tok 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 to tok

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools