Tolk

MCP server that compiles, validates, and explores Tolk language contracts for TON, enabling integration with MCP clients.

typescript

0

GitHub Stars

typescript

Language

3 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "oxgeneral-tolk-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "tolk-mcp-server"
      ]
    }
  }
}

You can compile, validate, and explore the Tolk smart contract language through an MCP server that integrates with various AI assistants. This server exposes tools to compile Tolk sources to the TON platform, quick syntax checks, and guided prompts to help you write or review contracts, all accessible from your MCP-enabled client.

How to use

You will interact with the Tolk MCP Server through your MCP client. Use the compile tool to turn Tolk source into deployment-ready output, the syntax checker to validate your code before deployment, and the reference and example resources to learn the language and model your contracts.

Typical workflows you can perform include: compiling a contract to obtain Fift assembly, BoC, and a code hash; quickly validating syntax for multi-file projects; and using guided prompts to draft new contracts or perform security reviews.

How to install

Prerequisites you need before running the MCP server are listed here.

Install and run the MCP server from source using these steps.

git clone https://github.com/oxgeneral/tolk-mcp-server.git
cd tolk-mcp-server
npm install
npm run build
npm start

Available tools

get_compiler_version

Returns the Tolk compiler version to help you verify the runtime and ensure compatibility with your deployment target.

compile_tolk

Compiles Tolk source code to Fift and Bag-of-Cells (BoC) with full compiler options including optimization level, stack comments, and experimental flags.

check_tolk_syntax

Performs quick syntax validation to catch errors before full compilation, returning an OK status with a code hash or detailed error information.

write_smart_contract

Guided prompt that assists you in drafting a new TON smart contract based on your requirements.

review_smart_contract

Guided prompt that performs security review and optimization analysis on an existing contract.