Add it to Claude Code
claude mcp add iz-tolk-mcp -- npx -y iz-tolk-mcpMake your agent remember this setup
iz-tolk-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Compile Tolk smart contracts with optimization levels and stack comments
- Support for multi-file compilation and @stdlib imports
- Generate deployment links for Tonkeeper and other TON wallets
- Built-in syntax checking and compiler version reporting
- Includes language guides and stdlib references as MCP resources
Tools 4
get_compiler_versionReturns the version of the Tolk compiler bundled in @ton/tolk-js.compile_tolkCompiles Tolk smart contract source code and returns Fift output, BoC, and code hash.check_tolk_syntaxChecks the syntax of Tolk smart contract source code.generate_deploy_linkGenerates ton:// deeplinks and Tonkeeper URLs for wallet deployment.Try it
Original README from izzzzzi/izTolkMcp
iz-tolk-mcp
MCP server for the Tolk smart contract compiler — compile, check, and deploy TON blockchain smart contracts from any AI assistant
🇷🇺 Русский | 🇬🇧 English
MCP server that brings the Tolk smart contract compiler directly into AI assistants like Claude — write, compile, check, and deploy TON contracts without leaving the conversation.
📖 Overview
iz-tolk-mcp is a Model Context Protocol (MCP) server that integrates the Tolk smart contract compiler into AI assistants, enabling a seamless write-compile-deploy workflow for TON blockchain development.
- Tolk is the next-generation smart contract language for the TON blockchain, designed as a modern successor to FunC with familiar syntax (C/TypeScript-like), type safety, and cleaner semantics.
- MCP (Model Context Protocol) is an open standard that lets AI assistants use external tools, access data sources, and follow guided workflows — turning them into capable development environments.
✨ Features
| Feature | Description |
|---|---|
| 🔨 4 MCP Tools | compile_tolk, check_tolk_syntax, get_compiler_version, generate_deploy_link |
| 📄 6 MCP Resources | Language guide, stdlib reference, changelog, FunC migration guide, example contracts |
| 💬 3 MCP Prompts | Guided workflows for writing, reviewing, and debugging smart contracts |
| ⚙️ Full Compiler Options | Optimization levels (0-2), stack comments, multi-file compilation |
| 📦 Multi-file Support | Compile projects with multiple .tolk source files and @stdlib/* imports |
| 🔗 Deployment Links | Generate ton:// deeplinks and Tonkeeper URLs for wallet deployment |
| 🚀 Zero Configuration | Runs via npx with no external dependencies beyond Node.js |
🚀 Quick Start
npx iz-tolk-mcp
The server communicates over stdio and is designed to be launched by an MCP client.
📦 Installation
Using npx (no install needed)
MCP clients launch the server automatically — just add it to your configuration (see below).
Global install
npm install -g iz-tolk-mcp
From source
git clone https://github.com/izzzzzi/izTolkMcp.git
cd izTolkMcp
npm install
npm run build
Requirement: Node.js >= 18
🔧 MCP Client Configuration
<details> <summary><b>Claude Desktop</b></summary>Add to claude_desktop_config.json:
{
"mcpServers": {
"tolk": {
"command": "npx",
"args": ["-y", "iz-tolk-mcp"]
}
}
}
claude mcp add tolk -- npx -y iz-tolk-mcp
Add to .cursor/mcp.json:
{
"mcpServers": {
"tolk": {
"command": "npx",
"args": ["-y", "iz-tolk-mcp"]
}
}
}
Add to ~/.windsurf/mcp.json:
{
"mcpServers": {
"tolk": {
"command": "npx",
"args": ["-y", "iz-tolk-mcp"]
}
}
}
Add to .vscode/mcp.json:
{
"servers": {
"tolk": {
"command": "npx",
"args": ["-y", "iz-tolk-mcp"]
}
}
}
{
"mcpServers": {
"tolk": {
"command": "node",
"args": ["/absolute/path/to/izTolkMcp/dist/index.js"]
}
}
}
🛠️ MCP Tools
🔍 `get_compiler_version`
Returns the version of the Tolk compiler bundled in @ton/tolk-js (WASM).
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters |
🔨 `compile_tolk`
Compiles Tolk smart contract source code. Returns Fift output, BoC (Bag of Cells) in base64, and the code hash.
| Parameter | Type | Required | Description |
|---|---|---|---|
entrypointFileName |