What it does
Tolk smart contract compiler for TON — compile, check, and deploy from AI assistants
- Connects パソコンで動く
- Account or key No key needed
- Category 開発者ツール
一緒に使える
この種の作業を AI に教える Skill。これと一緒に使えます
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
この順位の理由
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 6/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 3/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 9/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
インストール
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
iz-tolk-mcp — Tolk Compiler for TON をインストールして。https://mcp.popnx.com/i/izzzzzi-iz-tolk-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月13日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
AI にインストールしてもらう
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server iz-tolk-mcp — Tolk Compiler for TON を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "iz-tolk": { "command": "npx", "args": [ "-y", "iz-tolk-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、iz-tolk-mcp — Tolk Compiler for TON のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "iz-tolk": { "command": "npx", "args": [ "-y", "iz-tolk-mcp" ] } } }Claude を終了してもう一度開く
試してみる
iz-tolk-mcp — Tolk Compiler for TON を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が iz-tolk-mcp — Tolk Compiler for TON を使っていると言うか、回答に iz-tolk-mcp — Tolk Compiler for TON のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ iz-tolk-mcp — Tolk Compiler for TON につなげません
iz-tolk-mcp — Tolk Compiler for TON はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · iz-tolk-mcp — Tolk Compiler for TON につなげるアプリを使う
- 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
- 先にパソコンへ Node.js を入れてください(1 回だけ)
- 先にパソコンへ Node.js を入れてください(1 回だけ)
- 先にパソコンへ Node.js を入れてください(1 回だけ)
B · 開発者ツール の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server iz-tolk-mcp — Tolk Compiler for TON を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user iz-tolk -- npx -y iz-tolk-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、iz-tolk-mcp — Tolk Compiler for TON のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user iz-tolk -- npx -y iz-tolk-mcpClaude Code で /mcp と入力
iz-tolk-mcp — Tolk Compiler for TON が一覧にあり、接続済みと表示されれば OK です
試してみる
iz-tolk-mcp — Tolk Compiler for TON を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が iz-tolk-mcp — Tolk Compiler for TON を使っていると言うか、回答に iz-tolk-mcp — Tolk Compiler for TON のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server iz-tolk-mcp — Tolk Compiler for TON を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "iz-tolk": { "command": "npx", "args": [ "-y", "iz-tolk-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、iz-tolk-mcp — Tolk Compiler for TON のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
Cursor の AI チャットを Agent モードで開く
試してみる
iz-tolk-mcp — Tolk Compiler for TON を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が iz-tolk-mcp — Tolk Compiler for TON を使っていると言うか、回答に iz-tolk-mcp — Tolk Compiler for TON のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server iz-tolk-mcp — Tolk Compiler for TON を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "iz-tolk": { "type": "stdio", "command": "npx", "args": [ "-y", "iz-tolk-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、iz-tolk-mcp — Tolk Compiler for TON のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
Node.js を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -v- バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
node -v一度入れれば、Node.js を使うすべてのツールで使えます
VS Code の AI チャットを Agent モードで開く
試してみる
iz-tolk-mcp — Tolk Compiler for TON を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が iz-tolk-mcp — Tolk Compiler for TON を使っていると言うか、回答に iz-tolk-mcp — Tolk Compiler for TON のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
開発者向け:ターミナルのコマンドと JSON 設定
パソコンにインストール
Claude Code
claude mcp add --scope user iz-tolk -- npx -y iz-tolk-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"iz-tolk": {
"command": "npx",
"args": [
"-y",
"iz-tolk-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"iz-tolk": {
"command": "npx",
"args": [
"-y",
"iz-tolk-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"iz-tolk": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"iz-tolk-mcp"
]
}
}
}この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント izzzzzi で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新:5 か月前
- ✓ 合格
ライセンスがある
MITを使用
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
公開済みの脆弱性(OSV.dev)
OSV.dev に iz-tolk-mcp@1.2.1 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日
作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/izzzzzi-iz-tolk-mcp)話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
開発者ツールのほかのサーバーとの比較i
- このカテゴリのほかの6136件のうち77%よりスターが多い
- このカテゴリのほかの6136件のうち4%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの6136件のうち99%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
iz-tolk-mcp — Tolk Compiler for TONは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は5 か月前、最新バージョン(1.2.1)がレジストリに届いたのは8 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
似た働きのほかの候補
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| これ iz-tolk-mcp — Tolk Compiler for TON | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドでもパソコンにインストールでも使える |
| キーが必要 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | はい | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| ライセンス | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
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, 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
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
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": { "tolk": { "command": "npx", "args": ["-y", "iz-tolk-mcp"] } } }
Claude Code
claude mcp add tolk -- npx -y iz-tolk-mcp
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": { "tolk": { "command": "npx", "args": ["-y", "iz-tolk-mcp"] } } }
Windsurf
Add to ~/.windsurf/mcp.json:
{
"mcpServers": { "tolk": { "command": "npx", "args": ["-y", "iz-tolk-mcp"] } } }
VS Code (Copilot)
Add to .vscode/mcp.json:
{
"servers": { "tolk": { "command": "npx", "args": ["-y", "iz-tolk-mcp"] } } }
Local build (any client)
{
"mcpServers": { "tolk": { "command": "node", "args": ["/absolute/path/to/izTolkMcp/dist/cli.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, 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 |
|---|---|---|---|
entrypointFileName | string | ✅ | The main .tolk file to check |
sources | object | ✅ | Map of filename -> source code |
pathMappings | object | — | Maps @alias prefixes to folder paths for import resolution |
🔗 generate_deploy_link
Generates TON deployment deeplinks for a compiled contract. Computes the deterministic contract address and returns ton:// and Tonkeeper links ready for wallet deployment.
| Parameter | Type | Required | Description |
|---|---|---|---|
codeBoc64 | string | ✅ | Base64-encoded BoC of compiled contract code (from compile_tolk) |
initialDataBoc64 | string | — | Base64-encoded BoC for initial data cell (default: empty cell) |
workchain | number | — | Target workchain ID (default: 0) |
amount | string | — | Deploy amount in nanoTON (default: "50000000" = 0.05 TON) |
📄 MCP Resources
| Resource | URI | Description |
|---|---|---|
📘 language-guide | tolk://docs/language-guide | Complete Tolk language syntax reference |
📗 stdlib-reference | tolk://docs/stdlib-reference | Standard library modules and functions reference |
📋 changelog | tolk://docs/changelog | Tolk compiler version history from v0.6 to latest |
🔄 tolk-vs-func | tolk://docs/tolk-vs-func | FunC to Tolk migration guide — key differences and comparison |
📝 example-counter | tolk://examples/counter | Simple counter smart contract example in Tolk |
💎 example-jetton | tolk://examples/jetton | Jetton (fungible token) minter contract example in Tolk |
💬 MCP Prompts
write_smart_contract
Guided workflow for writing a new Tolk smart contract on TON. Injects the language reference and a relevant example contract into the conversation context.
| Argument | Type | Required | Description | ||||
|---|---|---|---|---|---|---|---|
description | string | ✅ | Description of what the smart contract should do | ||||
contractType | string | — | "counter" \ | "jetton" \ | "nft" \ | "wallet" \ | "custom" (default: "custom") |
review_smart_contract
Security-focused review of a Tolk smart contract. Checks for access control, message handling, integer overflow, gas management, storage integrity, and TON-specific vulnerabilities.
| Argument | Type | Required | Description |
|---|---|---|---|
code | string | ✅ | The Tolk smart contract source code to review |
debug_compilation_error
Diagnose and fix a Tolk compilation error. Analyzes the error against the language reference and provides corrected code.
| Argument | Type | Required | Description |
|---|---|---|---|
errorMessage | string | ✅ | The compilation error message from the Tolk compiler |
code | string | ✅ | The Tolk source code that failed to compile |
💡 Usage Examples
Once configured, interact with the Tolk MCP server through natural language in your AI assistant:
Compile a contract:
"Compile this Tolk smart contract:"
`tolk
import "@stdlib/tvm-dicts";
fun onInternalMessage(myBalance: int, msgValue: int, msgFull: cell, msgBody: slice) {
// handle messages
}
`
Write a new contract from scratch:
"Write a simple counter contract for TON that stores a number and lets anyone increment it. Include a getter to read the current value."
Review an existing contract:
"Review this contract for security issues" *(paste code)*
Debug a compilation error:
"I'm getting this error when compiling:
unexpected token 'fun'— here's my code:" *(paste code)*
Generate a deploy link:
"Generate a deployment link for the contract we just compiled."
📁 Project Structure
src/
├── index.ts — Server initialization and stdio transport ├── tools.ts — 4 MCP tools (compile, check, version, deploy) ├── resources.ts — 6 MCP resources (docs, examples) ├── prompts.ts — 3 MCP prompts (write, review, debug) └── content/ — Bundled documentation and example contracts ├── language-guide.md ├── stdlib-reference.md ├── changelog.md ├── tolk-vs-func.md ├── example-counter.tolk └── example-jetton.tolk
Key dependencies:
@modelcontextprotocol/sdk— MCP server framework@ton/tolk-js— Tolk compiler (WASM, runs locally)@ton/core— TON primitives for address computation and cell serializationzod— Schema validation for tool parameters
🧑💻 Development
npm install # Install dependencies
npm run build # Compile TypeScript + copy content files npm run dev # Run with tsx (hot reload for development) npm test # Run test suite (vitest) npm run lint # Check for lint errors npm run lint:fix # Fix lint errors automatically npm run format # Format code with Biome
Pre-commit hooks enforce code quality automatically:
- Biome — fast linter and formatter for TypeScript
- Husky — Git hooks manager
- lint-staged — runs checks only on staged files