izzzzzi/izTolkMcp

**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, path mappings, multi-file compilation |
| 📦 **Multi-file Support** | Compile projects with multiple .tolk source files, @stdlib/* and @fiftlib/* 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
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
From source
> **Requirement:** Node.js >= 18
---
🔧 MCP Client Configuration
Claude Desktop
Add to claude_desktop_config.json:
Claude Code
Cursor
Add to .cursor/mcp.json:
Windsurf
Add to ~/.windsurf/mcp.json:
VS Code (Copilot)
Add to .vscode/mcp.json:
Local build (any client)
---
🛠️ 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, code hash, and compiler version.
| Parameter | Type | Required | Description |
|-----------|------|:--------:|-------------|
| entrypointFileName | string | ✅ | The main .tolk file to compile (e.g., "main.tolk") |
| sources | object | ✅ | Map of filename -> source code. Must include the entrypoint file. |
| optimizationLevel | number | — | Optimization level 0-2 (default: 2) |
| withStackComments | boolean | — | Include stack layout comments in Fift output |
| pathMappings | object | — | Maps @alias prefixes to folder paths for import resolution |
✅ check_tolk_syntax
Checks Tolk source code for syntax and type errors without returning full compilation output. Faster feedback loop for iterative development.
| Parameter | Type | Required | Description |
|-----------|------|:--------:|-------------|