TON Blockchain

Provides a model context protocol server enabling natural language queries and analytics on the TON blockchain.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "devonmojito-ton-blockchain-mcp": {
      "command": "/Users/devon/ton-mcp/ton-blockchain-mcp/venv/bin/python",
      "args": [
        "-m",
        "tonmcp.mcp_server"
      ],
      "env": {
        "PYTHONPATH": "/Users/devon/ton-mcp/ton-blockchain-mcp/src",
        "TON_API_KEY": "YOUR_TON_API_KEY"
      }
    }
  }
}

You can interact with the TON blockchain using a dedicated MCP server that translates natural language queries into actionable data requests. This server enables natural language processing, trading analysis, hot trends detection, forensics and compliance checks, and real-time TON data access, all accessible through compatible MCP clients.

How to use

Set up your MCP client to connect to the TON blockchain MCP server. You will provide natural language questions or prompts, such as asking for wallet balances, trending tokens, or transaction details. The server exposes tools that let you analyze addresses, fetch transaction details, detect hot trends, analyze trading patterns, and retrieve current TON prices. Use plain language queries in your MCP client and let the server return structured insights and analyses.

How to install

Prerequisites: ensure you have Python 3.10 or newer installed on your system.

Install and run the MCP server by following these steps exactly.

Additional sections

Environment configuration: Create a .env file at the project root to securely store sensitive configuration, such as your TON API key.

Example .env content:

TON_API_KEY=YOUR_TON_API_KEY

Available tools

analyze_address

Analyze a TON address for balance, jetton holdings, NFTs, and recent activity; optionally perform deep forensic analysis.

get_transaction_details

Retrieve details and analysis for a specific TON transaction by its hash.

find_hot_trends

Identify trending tokens, pools, or accounts within a given timeframe and category.

analyze_trading_patterns

Analyze trading activity for a TON address over a specified timeframe, including DEX swaps.

get_ton_price

Fetch the real-time TON price in a chosen currency and track recent changes.

get_jetton_price

Fetch prices for specified jetton tokens (excluding TON) in a chosen currency.

Built by

VeilStrat

AI signals for GTM teams