TON Access

🚀 TON Access MCP Server

A production-grade implementation of the Model Context Protocol (MCP) server for the TON blockchain, built on the ton-access library.

🚀 Quick Start

import { TonAccessMCPServer } from 'ton-access-mcp';

// Create and start the server
const server = new TonAccessMCPServer({
  port: 3000,
  host: 'localhost'
});

server.start().then(() => {
  console.log('TON Access MCP Server has been started and is running at http://localhost:3000');
});

✨ Features

• Full MCP Implementation: Implements the complete MCP specification for connecting AI assistants to the TON blockchain.
• Decentralized Access: Ensures reliability and decentralization by using multiple nodes.
• Health Check: Automatically checks node status and selects healthy nodes.
• Load Balancing: Distributes requests using a weighted random algorithm.
• Multi-Network Support: Supports both the mainnet and testnet simultaneously.
• Multiple Protocol Support: Supports different RPC protocols (TonCenter HTTP API v2, TonHub HTTP API v4).

📦 Installation

# Clone the repository
git clone https://github.com/your-org/ton-access-mcp.git
cd ton-access-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

🔍 What is MCP?

The Model Context Protocol (MCP) is an open protocol developed by Anthropic, aiming to standardize the way applications provide context to large language models (LLMs). It uses a client-server architecture, where LLM applications (hosts) connect to MCP servers to obtain context, tools, and prompts.

💻 Usage Examples

Available Tools

The TON Access MCP Server provides the following tools:

• ton.getBalance: Get the balance of a TON wallet address.
• ton.getTransaction: Get detailed information about a TON blockchain transaction.
• ton.getBlock: Get detailed information about a TON blockchain block.
• ton.callGetter: Call a getter method on a TON smart contract.
• ton.getMasterchainInfo: Get information about the current TON main chain.
• ton.getAccountState: Get the current state of a TON account.

📚 Documentation

For detailed documentation, please refer to the docs directory.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Orbs Network: Thanks for providing the ton-access library.
• Anthropic: Thanks for the MCP specification.