TON Blockchain MCP Server

What does “TON Blockchain” MCP Server do?

The TON Blockchain MCP Server is a Model Context Protocol (MCP) server written in Python designed for natural language interaction with the TON blockchain. It acts as a bridge between AI assistants and the TON blockchain, allowing users to query and analyze blockchain data using plain English. This server leverages natural language processing to understand complex blockchain queries, perform trading analysis, detect hot trends, conduct forensics and compliance checks, and provide real-time data access through the TON API. By connecting external data sources and services, the TON Blockchain MCP Server enhances development workflows, enabling tasks such as scam detection, address analysis, transaction detail retrieval, and trading pattern analysis.

List of Prompts

No prompt templates are explicitly mentioned in the repository.

List of Resources

No explicit MCP resources are described in the repository documentation or code.

List of Tools

No explicit list of tools is provided or discoverable in the repository’s documentation or code.

Use Cases of this MCP Server

• Scam Detection
  Use natural language to analyze suspicious addresses and detect potential scam activity on the TON blockchain, aiding compliance and user safety.
• Analyze Blockchain Address
  Investigate the activity, balance, and transaction history of specific TON addresses, facilitating forensics or due diligence.
• Get Transaction Details
  Retrieve detailed information about specific transactions, including participants, amounts, and timestamps, for audit or research purposes.
• Analyze Trading Patterns
  Examine trading histories, profitability, and strategies associated with addresses or pools, helping users optimize their trading or understand market dynamics.
• Hot Trends Detection
  Identify trending tokens, active pools, and high-activity accounts to uncover emerging opportunities within the TON ecosystem.

How to set it up

Windsurf

1. Ensure Python 3.10+ is installed and obtain a TON API key from TONAPI.
2. Clone the repository and install dependencies:

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

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

   TON_API_KEY=YOUR_TON_API_KEY
   

4. Edit your Windsurf configuration to add the MCP server:

   {
     "mcpServers": {
       "ton-blockchain-mcp": {
         "command": "python",
         "args": ["src/main.py"]
       }
     }
   }
   

5. Restart Windsurf and verify the server appears in the MCP list.

Securing API Keys Example:

{
  "mcpServers": {
    "ton-blockchain-mcp": {
      "command": "python",
      "args": ["src/main.py"],
      "env": {
        "TON_API_KEY": "YOUR_TON_API_KEY"
      },
      "inputs": {}
    }
  }
}

Claude

1. Ensure Python 3.10+ is installed and obtain a TON API key.
2. Clone and install as above.
3. In Claude Desktop config, add:

   {
     "mcpServers": {
       "ton-blockchain-mcp": {
         "command": "python",
         "args": ["src/main.py"]
       }
     }
   }
   

4. Save and restart Claude Desktop.
5. Verify the TON MCP server is available.

Environment Securing Example:

{
  "mcpServers": {
    "ton-blockchain-mcp": {
      "command": "python",
      "args": ["src/main.py"],
      "env": {
        "TON_API_KEY": "YOUR_TON_API_KEY"
      }
    }
  }
}

Cursor

1. Install Python 3.10+ and the TON MCP server as described above.
2. Go to Cursor’s MCP server configuration.
3. Add the server:

   {
     "mcpServers": {
       "ton-blockchain-mcp": {
         "command": "python",
         "args": ["src/main.py"]
       }
     }
   }
   

4. Restart Cursor and check MCP server connectivity.
5. Ensure .env or environment variables are set for security.

Cline

1. Install prerequisites and the MCP server.
2. Access Cline’s configuration.
3. Insert:

   {
     "mcpServers": {
       "ton-blockchain-mcp": {
         "command": "python",
         "args": ["src/main.py"]
       }
     }
   }
   

4. Save changes, restart Cline, and verify the MCP server.
5. Ensure the TON_API_KEY is securely provided via environment variables.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "ton-blockchain-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “ton-blockchain-mcp” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

I would rate this MCP implementation as a 4/10. While it covers the basics of blockchain interaction and includes real-world use cases, it lacks clear documentation on prompts, resources, and tools, which are central MCP primitives.

MCP Score