Ton Blockchain MCP

Ton Blockchain MCP

What is Ton Blockchain MCP about?

Ton Blockchain MCP offers a Model Context Protocol (MCP) server that translates plain‑English queries into actionable blockchain analytics. It connects to the TON API to fetch live data and supplies tools for address analysis, transaction details, hot‑trend discovery, trading‑pattern evaluation, and real‑time pricing.

How to use Ton Blockchain MCP?

1. Prerequisites – Install Python 3.10+, obtain a TON API key from TONAPI.
2. Clone & install

   git clone https://github.com/devonmojito/ton-blockchain-mcp.git
   cd ton-blockchain-mcp
   pip install -r requirements.txt
   

3. Configure – Create a .env file in the project root:

   TON_API_KEY=YOUR_TON_API_KEY
   

4. Run the server

   python -m tonmcp.mcp_server
   

5. Integrate – Add the server definition to Claude Desktop (or any MCP‑compatible client) using the provided JSON snippet.

Key features of Ton Blockchain MCP

• Natural‑language processing for complex blockchain queries.
• analyze_address: balance, jetton holdings, NFTs, recent activity, optional deep forensic analysis.
• get_transaction_details: full details and analysis of a transaction hash.
• find_hot_trends: trending tokens, pools, or accounts over selectable timeframes.
• analyze_trading_patterns: trading activity insight for a specific address.
• get_ton_price & get_jetton_price: real‑time price data in any supported currency.
• System prompts for trading analysis, forensics investigation, and trend analysis.
• Ready‑to‑use configuration for Claude Desktop.

Use cases of Ton Blockchain MCP

• Wallet monitoring – Ask “What’s the balance of address EQD1234…?” to get an instant overview.
• Scam detection – Query suspicious activity for any address and receive forensic insights.
• Market research – “Find hot trading pairs in the last hour” to spot emerging opportunities.
• Trading strategy evaluation – Analyze past trades of a wallet to gauge profitability.
• Compliance – Generate reports on money‑flow tracing and AML checks.

FAQ from the Ton Blockchain MCP

Q: Do I need any special hardware? A: No, the server runs on any machine capable of Python 3.10+.

Q: Is the data real‑time? A: Yes, it pulls live information from the TON API.

Q: Can I use the server with other LLMs besides Claude Desktop? A: Absolutely – any client that speaks the MCP protocol can connect.

Q: What limits does the free TONAPI key have? A: Rate limits are imposed by TONAPI; refer to their documentation for details.

Q: Is this a financial advisory tool? A: No. The project is in beta and provides no financial advice; use at your own risk.

TON BLOCKCHAIN MCP

A Model Context Protocol (MCP) server for natural language interaction with the TON blockchain.

Features

• Natural Language Processing: Understand complex blockchain queries in plain English
• Trading Analysis: Analyze trading patterns, profitability, and strategies
• Hot Trends Detection: Find trending tokens, active pools, and high-activity accounts
• Forensics & Compliance: Conduct blockchain investigations and compliance checks
• Real-time Data: Access live TON blockchain data through TON API

Quick Start

Prerequisites

• Python 3.10+
• TON API key from TONAPI

Environment Configuration (.env)

To securely provide sensitive configuration (such as your TON API key), create a .env file in the project root directory. This file will be loaded automatically if present.

Example .env file:

TON_API_KEY=YOUR_TON_API_KEY

Installation

1. Clone the repository:

git clone https://github.com/devonmojito/ton-blockchain-mcp.git
cd ton-blockchain-mcp

2. Install dependencies:

pip install -r requirements.txt

---

Using TON MCP Server with Claude Desktop

You can easily use this MCP server with Claude Desktop for natural language blockchain queries. Below are some example use cases:

Scam Detection Example:

Analyze Address Example:

Get Transaction Details Example:

Analyze Trading Patterns Example:

Claude Desktop Configuration Example

To use this MCP server with Claude Desktop, add the following to your Claude Desktop config:

• You might need to replace the Python env setup with your own.

{
    "mcpServers":
    {
        "ton-mcp-server":
        {
            "command": "/Users/devon/ton-mcp/ton-blockchain-mcp/venv/bin/python",
            "args":
            [
                "-m",
                "tonmcp.mcp_server"
            ],
            "cwd": "/Users/devon/ton-mcp/ton-blockchain-mcp/src",
            "env":
            {
                "PYTHONPATH": "/Users/devon/ton-mcp/ton-blockchain-mcp/src"
            },
            "stdio": true
        }
    }
}

---

Natural Language Examples

• "What's the balance of address EQD1234...?"
• "Find hot trading pairs in the last hour"
• "Analyze trading patterns for this wallet"
• "Show suspicious activity for address ABC"
• "Trace money flow from this address"

MCP Tools & System Prompts Documentation

Tools

analyze_address

Analyze a TON address for its balance, jetton holdings, NFTs, and recent activity. Optionally performs deep forensic analysis if deep_analysis is True. Use for questions about account overview, holdings, or activity.

Parameters:

• address (str): TON address to analyze
• deep_analysis (bool, optional): Enable deep forensic analysis

get_transaction_details

Get details and analysis for a specific TON blockchain transaction by its hash. Use for questions about a particular transaction, its participants, value, or type.

Parameters:

• tx_hash (str): Transaction hash

find_hot_trends

Find trending tokens, pools, or accounts on the TON blockchain for a given timeframe and category. Use for questions about what's hot, trending, or popular on TON.

Parameters:

• timeframe (str, optional): Time period (e.g., 1h, 24h, 7d)
• category (str, optional): Type of trends (tokens, pools, accounts)

analyze_trading_patterns

Analyze trading patterns for a TON address over a specified timeframe. Use for questions about trading activity, frequency, jetton transfers, or DEX swaps for an account.

Parameters:

• address (str): TON address
• timeframe (str, optional): Time period (e.g., 24h)

get_ton_price

Get the current real-time TON price in the specified currency (default: USD) and recent price changes. Use this tool whenever you need the latest TON price for calculations, analysis, or reporting.

Parameters:

• currency (str, optional): The fiat or crypto currency to get the TON price in (default: 'usd').

get_jetton_price

Get the current price and recent changes for specified jetton tokens (not TON) in the given currency. Provide a list of jetton master addresses as tokens. Use this tool to fetch real-time prices for any token except TON.

Parameters:

• tokens (list of str): List of jetton master addresses to get prices for (excluding 'ton').
• currency (str, optional): The fiat or crypto currency to get the price in (default: 'usd').

System Prompts

• trading_analysis: Generate trading analysis prompts
• forensics_investigation: Generate forensics prompts
• trend_analysis: Generate trend analysis prompts

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support, please open an issue on GitHub

⚠️ WARNING: This project is in Beta. Do not trust any numbers provided by the LLM model. Nothing in this project constitutes financial advice. Use at your own risk.