Ton Blockchain MCP
by
A Model Context Protocol (MCP) server written in Python for natural language interaction with the TON blockchain.
Ton Blockchain MCP Overview
What is TON Blockchain MCP?
TON Blockchain MCP is a Python-based Model Context Protocol (MCP) server designed to enable natural language interaction with the TON blockchain. It allows users to query and analyze blockchain data using plain English, making complex blockchain information more accessible.
How to use TON Blockchain MCP?
To use TON Blockchain MCP, you need Python 3.10+ and a TON API key from TONAPI. After cloning the repository and installing dependencies, you can configure your TON API key in a .env file. The server can then be integrated with Claude Desktop by adding specific mcpServers configuration to your Claude Desktop settings. This setup allows you to send natural language queries to the TON blockchain through Claude Desktop.
Key Features of TON Blockchain MCP
- Natural Language Processing: Understands complex blockchain queries in plain English.
- Trading Analysis: Analyzes trading patterns, profitability, and strategies.
- Hot Trends Detection: Identifies trending tokens, active pools, and high-activity accounts.
- Forensics & Compliance: Facilitates blockchain investigations and compliance checks.
- Real-time Data: Provides access to live TON blockchain data via TON API.
Use Cases of TON Blockchain MCP
- Scam Detection: Identify suspicious activities and potential scams on the blockchain.
- Address Analysis: Analyze balances, jetton holdings, NFTs, and recent activities of a TON address.
- Transaction Details: Get detailed information about specific TON blockchain transactions.
- Trading Pattern Analysis: Examine trading behaviors and patterns for a given wallet.
- Market Trend Monitoring: Discover hot trading pairs and trending assets.
- Price Information: Retrieve real-time prices for TON and other jetton tokens.
FAQ from TON Blockchain MCP
Q: What are the prerequisites for running TON Blockchain MCP? A: You need Python 3.10+ and a TON API key from TONAPI.
Q: How do I provide my TON API key?
A: Create a .env file in the project root directory and add TON_API_KEY=YOUR_TON_API_KEY.
Q: Can I use this with Claude Desktop? A: Yes, the README provides detailed instructions and an example configuration for integrating with Claude Desktop.
Q: What kind of natural language queries can I make? A: You can ask questions like "What's the balance of address EQD1234...?", "Find hot trading pairs in the last hour", or "Analyze trading patterns for this wallet."
Q: Is this project stable? A: The project is currently in Beta. It is advised not to trust any numbers provided by the LLM model for financial advice, and to use it at your own risk.
Ton Blockchain MCP's README
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
- Clone the repository:
git clone https://github.com/devonmojito/ton-blockchain-mcp.git
cd ton-blockchain-mcp
- 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 analyzedeep_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 addresstimeframe(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 promptsforensics_investigation: Generate forensics promptstrend_analysis: Generate trend analysis prompts
Contributing
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- 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.
Ton Blockchain MCP Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Ton Blockchain MCP's Information
- Author
- devonmojito
- Category
- Data & Analytics
- Language
- Python
- License
- MIT License
- Stars
- 13
- Updated
- 3 months ago
Related MCP Servers
Discover more MCP servers with similar functionality and use cases
Vizro
by mckinsey
Build high-quality data visualization apps quickly with low‑code configuration, leveraging Plotly, Dash, and Pydantic while allowing deep customisation through Python, JavaScript, HTML, and CSS.
AntV Chart
by antvis
mcp-server-chart is a Model Context Protocol (MCP) server developed by AntV that generates over 25 types of visual charts. It provides robust chart generation and data analysis capabilities, integrating with various AI clients and platforms.
Data Exploration
by reading-plus-ai
mcp-server-data-exploration is an MCP server designed for autonomous data exploration on CSV-based datasets. It acts as a personal Data Scientist assistant, providing intelligent insights with minimal effort.
Wren Engine
by Canner
Wren Engine is a semantic engine designed for Model Context Protocol (MCP) clients and AI agents, enabling accurate and context-aware access to enterprise data.
QuickChart
by GongRzhe
A Model Context Protocol (MCP) server for generating various types of charts using QuickChart.io, enabling chart creation through MCP tools.
BigQuery
by ergut
mcp-bigquery-server is a Model Context Protocol (MCP) server that enables Large Language Models (LLMs) to securely and efficiently interact with Google BigQuery datasets. It acts as a translator, allowing LLMs to query and analyze data in BigQuery using natural language instead of SQL.
Mcp Vegalite Server
by isaacwasserman
Provides tools for saving data tables and generating Vega‑Lite visualizations via an MCP interface, supporting both textual specifications and PNG image output.
Google Analytics
by surendranb
Google Analytics MCP Server is a Python-based tool that enables Large Language Models (LLMs) to access and analyze Google Analytics 4 (GA4) data using natural language, providing conversational querying of over 200 GA4 dimensions and metrics.
Mcp Tinybird
by tinybirdco
Provides a Model Context Protocol server implementation for Tinybird, allowing analytics agents to forward data to Tinybird's platform.