# Tolk MCP Server

> Tolk MCP Server is an open-source MCP server for legal and government. MCP server that compiles and validates Tolk smart contracts for TON developers. It is available on CLI, API and self-hosted.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/oxgeneral/tolk-mcp-server
- **MCP Registry name:** io.github.oxgeneral/tolk-mcp-server
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-18

## About

The server wraps the Tolk compiler so an AI assistant can compile TON contract source into Fift assembly and BoC, check syntax without full output, and pull reference material and example contracts. Multi-file projects are supported by passing several source files with an entrypoint name, and standard library imports are resolved by the compiler.

It exposes three tools for compiling, syntax checking and reading the compiler version, plus resources for a Tolk language reference covering differences from FunC, along with counter, wallet and jetton examples. Compiler settings such as optimization level, stack comments and experimental flags can be adjusted per call.

The README targets developers writing or reviewing TON smart contracts in MCP-compatible clients such as Claude Desktop, Cursor and Windsurf. It requires Node.js 18 or later and is released under the MIT license.

## Features

- **Contract compilation:** Compiles Tolk source to Fift assembly and a base64 BoC with a code hash and warnings.
- **Quick syntax check:** Validates Tolk syntax and reports errors with line and column information.
- **Multi-file projects:** Accepts several source files with an entrypoint so imports between files resolve.
- **Adjustable compiler options:** Sets optimization level, stack comments and experimental flags for each compile.
- **Language reference resource:** Provides a Tolk quick reference covering syntax, types and differences from FunC.
- **Example contracts:** Includes counter, wallet and jetton skeleton examples as readable resources.

## Good for

- Compile a TON contract from inside an AI coding assistant before deployment
- Catch Tolk syntax errors quickly while drafting a contract
- Learn Tolk syntax and differences from FunC using the bundled reference
- Start a new wallet or jetton contract from the provided examples

## Tools

- `get_compiler_version`: Returns the Tolk compiler version.
- `compile_tolk`: Compiles Tolk source code to Fift and BoC with compiler options.
- `check_tolk_syntax`: Validates Tolk syntax without full output.

## FAQ

### How do I install the server?

The README shows an npx-based config entry for Claude Desktop and Cursor or Windsurf, and a from-source setup using npm install and npm run build.

### What does compile_tolk return?

According to the README it returns Fift assembly, a base64 BoC ready for deployment, the code hash and any warnings.

### What are the requirements?

Node.js 18 or later. The README says there are no external dependencies beyond npm packages.

### What license is it under?

The README states the project is released under the MIT license.

### Is Tolk MCP Server free?

Yes. Tolk MCP Server is open source, so you can use and self-host it for free.

### What are the best alternatives to Tolk MCP Server?

The closest alternatives to Tolk MCP Server are Adeu, IAJUS Direito Brasileiro, 網紅開團合規工具箱, TokenOS Smart Contract Audit and Muckaway Ai MCP.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.

## Alternatives

- [Adeu](https://ai-powered.com/mcp/adeu): Adeu is an open-source MCP server for files and documents.
- [IAJUS Direito Brasileiro](https://ai-powered.com/mcp/iajus-direito-brasileiro): IAJUS Direito Brasileiro is an MCP server for legal and government.
- [網紅開團合規工具箱](https://ai-powered.com/mcp/listing-41): 網紅開團合規工具箱 is an MCP server for legal and government.
- [TokenOS Smart Contract Audit](https://ai-powered.com/mcp/tokenos-smart-contract-audit): TokenOS Smart Contract Audit is an MCP server for legal and government.
- [Muckaway Ai MCP](https://ai-powered.com/mcp/muckaway-ai-mcp): Muckaway Ai MCP is an open-source MCP server for legal and government.
- [IAJUS - Jurisprudência PT](https://ai-powered.com/mcp/iajus-jurisprudencia-pt): IAJUS - Jurisprudência PT is an MCP server for legal and government.
- [Rechtssysteem.ai](https://ai-powered.com/mcp/rechtssysteem-ai): Rechtssysteem.ai is an MCP server for legal and government.
- [Landlaw Ai MCP](https://ai-powered.com/mcp/landlaw-ai-mcp): Landlaw Ai MCP is an open-source MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/tolk-mcp-server
