analyze_addressLABSCO SUMMARY
Chain analysis without the block explorer.
The questions people actually take to an explorer — is this address a scam, did this wallet make money, what is moving right now — are the ones this answers directly, so an investigation stays in one thread instead of twenty tabs.
What it is
A Python MCP server over the TON API. It takes natural-language blockchain questions and resolves them against live TON data: addresses, transactions, trading behaviour and network activity.
What you get
- An address analysed — what it is and what it has been doing
- The full detail of a specific transaction by hash
- Trading patterns analysed, including profitability and strategy
- Trending tokens, active pools and high-activity accounts surfaced
- A deeper investigation pass for forensics and compliance work
Requirements
Python 3.10 or newer and a TON API key, which you register for at tonconsole.com — put it in a .env file in the project root, where the server picks it up automatically. Install with pip install -r requirements.txt. The client config runs it as python -m tonmcp.mcp_server with PYTHONPATH pointing at the repository's src directory; get that path wrong and the server will not start.
Setup effort
Build from source — git clone https://github.com/devonmojito/ton-blockchain-mcp.git
USE CASES
01
Working out whether an address is safe to deal with
Analyse the address and read what it has been doing before you send anything.
02
Understanding one transaction properly
Pull the full detail for the hash rather than reading a raw explorer page.
03
Judging whether a wallet knows what it is doing
Analyse its trading patterns — profitability and strategy, not just balance.
04
Finding what is moving today
Surface trending tokens, active pools and high-activity accounts in one call.
05
Running a compliance check that has to hold up
Take the deeper investigation pass over the address and the transactions behind it.
6 tools
Listed in project docs. Your client may show a different list.
get_transaction_detailsfind_hot_trendsanalyze_trading_patternsget_ton_priceget_jetton_priceBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
- Python 3.10+
- TON_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/devonmojito/ton-blockchain-mcp.git
cd ton-blockchain-mcp
pip install -r requirements.txtCreate a .env file in the project root directory containing TON_API_KEY=<YOUR_TON_API_KEY>
MCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"ton-mcp-server": {
"command": "<YOUR_PATH_TO_TON_BLOCKCHAIN_MCP>/venv/bin/python",
"args": [
"-m",
"tonmcp.mcp_server"
],
"cwd": "<YOUR_PATH_TO_TON_BLOCKCHAIN_MCP>/src",
"env": {
"PYTHONPATH": "<YOUR_PATH_TO_TON_BLOCKCHAIN_MCP>/src"
},
"stdio": true
}
}
}The command runs the Python inside a venv folder in your clone, which these steps do not create. Point it at the Python you installed the requirements with — the README notes that the Python env setup may need to be your own.
The configuration on this page does not set TON_API_KEY; the project's instructions put it in a .env file. To supply TON_API_KEY without depending on where the server looks for that file, use the block's "env" section.
