oxgeneral avatar

Tolk MCP Server

oxgeneral/tolk-mcp-server

Bridges the Tolk smart contract compiler directly into Claude and other MCP clients for TON blockchain development. You get three compilation tools: full compile to Fift assembly and BoC, quick syntax checks, and compiler version lookup. Resources include language references and contract examples for counters, wallets, and jettons. Two guided prompts walk you through writing new contracts or reviewing existing ones for security and optimization. Handles multi-file projects with automatic stdlib resolution and exposes full compiler options including optimization levels and experimental flags. Reach for this when you're developing TON contracts and want compilation feedback without leaving your AI assistant.

tools
3
last updated
Feb 22, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

get_compiler_versionReturns the Tolk compiler version

Returns the Tolk compiler version

No parameter schema in public metadata yet.

compile_tolkCompiles Tolk source code to Fift + BoC with full compiler options (optimization level, stack comments, experimental flags)

Compiles Tolk source code to Fift + BoC with full compiler options (optimization level, stack comments, experimental flags)

No parameter schema in public metadata yet.

check_tolk_syntaxQuick syntax validation without full output

Quick syntax validation without full output

No parameter schema in public metadata yet.

Sponsors

Readme

tolk-mcp-server

MCP server for the Tolk smart contract compiler. Compile, validate, and explore TON smart contracts from any MCP-compatible AI assistant (Claude Desktop, Cursor, Windsurf, etc.).

Features

Tools:

  • get_compiler_version — Returns the Tolk compiler version
  • compile_tolk — Compiles Tolk source code to Fift + BoC with full compiler options (optimization level, stack comments, experimental flags)
  • check_tolk_syntax — Quick syntax validation without full output

Resources:

  • tolk://reference — Tolk language quick reference (syntax, types, differences from FunC)
  • tolk://examples/hello-world — Counter contract example
  • tolk://examples/wallet — Wallet contract example
  • tolk://examples/jetton — Jetton (token) contract skeleton

Prompts:

  • write_smart_contract — Guided prompt for writing a new TON smart contract
  • review_smart_contract — Guided prompt for security review and optimization analysis

Quick Start

Claude Desktop

Add to claude_desktop_config.json:


View the full README on GitHub

Details

Repository
github.com/oxgeneral/tolk-mcp-server
Registry
MCP registry, active

More from oxgeneral