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.
Metadata
Release files for iflow-mcp_ton-blockchain-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_ton_blockchain_mcp-0.1.0.tar.gz | 24.4 kB | Without provenance | Details for iflow_mcp_ton_blockchain_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_ton_blockchain_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_ton_blockchain_mcp-0.1.0-py3-none-any.whl |
Total release size: 51.9 kB
Release files / iflow_mcp_ton_blockchain_mcp-0.1.0.tar.gz
| Download URL | iflow_mcp_ton_blockchain_mcp-0.1.0.tar.gz |
|---|---|
| Size | 24.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
72a3e3af6bd8489ceac148a22074004a1baef101584cfec567489ead76eb5a0b
|
|
BLAKE2b-256 checksum How to use checksums |
cc0cfe4e1d42274387c465ef9fbea88cca97c07e1bec08cfed00641182af2dbe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_ton_blockchain_mcp-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_ton_blockchain_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 27.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3aecec0e09335fc7db75391c3632cd079d4486c9a6257c393548c44df8fec61d
|
|
BLAKE2b-256 checksum How to use checksums |
6c67688ac8c9ea6e4a1e174a7c314acc5b9897b58df387bb3ccd8da74d92fa2d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_ton-blockchain-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.