tok
MCP server for writing, checking and converting BPMN and DMN models in tok text
- 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-langAdd to claude_desktop_config.json
{
"mcpServers": {
"tok": {
"command": "uvx",
"args": [
"tok-lang"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tok": {
"command": "uvx",
"args": [
"tok-lang"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools