TON API Model Context Protocol (MCP) server for integrating TON API with AI assistants
Three tools with complete schemas and descriptions, but quality is uneven. call_method has a verbose, example-heavy description that violates best practices (includes sample addresses like 'EQBInPs62kcCSGDwnCTx0FLzgNpu_t6sTca-mOXInYPBISzT' which LLMs will reuse literally). list_modules and list_methods lack output schema documentation. Parameters are typed (good) but descriptions are generic. No error handling guidance, no idempotent/destructive hints. Naming is verb-first (good), but call_method is vague, does not clearly distinguish what 'calling a method' entails vs. discovery tools.
Call TON API method from any module. Specify module and method names. Parameters can be passed as a JSON object in 'params' or as array in 'args'. Query data similar to https://tonscan.org or https://tonviewer.com explorers. Example: view account at https://testnet.tonscan.org/address/EQBInPs62kcCSGDwnCTx0FLzgNpu_t6sTca-mOXInYPBISzT
List all methods in a specific TON API module. Get methods for querying data that appears on https://tonscan.org or https://tonviewer.com explorers.
List all TON API modules. Includes 'blockchain' for data shown on https://tonscan.org, 'accounts' for wallet info as displayed on https://tonviewer.com.
call_method description includes concrete example addresses (EQBInPs62kcCSGDwnCTx0FLzgNpu_t6sTca-mOXInYPBISzT). LLMs reuse example values literally in real calls, causing failures. Replace with format constraints and remove sample data.
Output schemas not documented for list_modules and list_methods. LLMs cannot plan downstream tool calls or extract fields without knowing response structure. Document what fields are returned.
No error handling guidance. If call_method fails (invalid module, network error, API key missing), responses do not tell the LLM what to do next. Add recovery hints like 'Call list_modules() to see available modules.'
call_method is vague. Name does not convey that it executes arbitrary TON API methods. Consider rename to 'execute_ton_api_method' or 'query_ton_blockchain' to clarify intent vs. discovery tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
No tool annotations (readOnlyHint, idempotentHint). All three tools are read-only and idempotent, but this is not declared in the schema. Add annotations to help agents reason about safety and retry behavior.