base-network-ledger-interface-module

This constitutes an MCP server specifically engineered for the Base ledger ecosystem. It empowers Large Language Models (LLMs) to orchestrate blockchain activities on the Base network using conversational input, encompassing custodial asset administration, asset visibility verification, and transactional deployments.

This module supports operational continuity across the official Base Mainnet and the Base Sepolia pre-production realm.

Functionalities (Tools)

The subsequent functions are accessible via this service interface:

execute_linguistic_instruction

Handles the interpretation and processing of a spoken command targeted at Base network processes. It mandates the following input parameter:

instruction_text: The conversational directive to be resolved (e.g., "Dispatch 0.5 Ether to the recipient address 0x1234...")

It yields a formalized output detailing the outcome of the requested action, including definitive transaction metadata for transfers, current asset holdings for balance inquiries, and credential repository specifics for new account generation.

instantiate_custodial_account

Provisions a completely new digital asset repository (wallet) within the Base network scope. It accepts one optional parameter:

alias_label: An identifier (string) to tag the created repository.

It returns a data structure containing the repository's public address, its assigned designation, and supplementary metadata.

retrieve_asset_level

Queries the current holdings for a specified or default repository on the Base ledger.

repository_identifier: (Optional) The designated name or public address of the repository to inspect (defaults to the primary configured repository).

It furnishes the retrieved asset quantity, denominated in Ether (ETH).

catalog_active_repositories

Generates a comprehensive inventory of every accessible custodial repository.

It returns an array structure where each element is a repository object detailing its address, assigned alias, and related attributes.

Integration Guide

Using Claude Desktop Environment

Claude Desktop is a favored interface client that natively incorporates the Model Context Protocol (MCP). You can seamlessly link your Base ledger service instance to Claude Desktop to enact blockchain operations via plain language.

You can integrate supplementary MCP services into Claude Desktop through modification of its configuration file located at:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

To onboard your Base ledger service, incorporate the subsequent JSON object snippet into the mcpServers section of the configuration file:

{
  "mcpServers": {
    "base": {
      "command": "npx",
      "args": [
        "-y",
        "base-network-mcp-server"
      ],
      "env": {
        "BASE_PROVIDER_URL": "https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY",
        "WALLET_PRIVATE_KEY": "your_private_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Configuration Parameters

BASE_PROVIDER_URL: The Uniform Resource Locator (URL) pointing to the Base network RPC endpoint (either Mainnet or Sepolia).
WALLET_PRIVATE_KEY: The cryptographic secret key required for identity authentication and transaction authorization/signing.
DEFAULT_GAS_PRICE: (Optional) The standard transaction fee setting, expressed in Gwei units.

Programmatic Connection (Custom MCP Client Development)

Should you be developing a bespoke MCP client application, connectivity to the Base service module can be established programmatically utilizing your preferred communication conduit. The official MCP Software Development Kit (SDK) furnishes built-in support for stdio and Server-Sent Events (SSE) transports.

Installation Procedure

npm install base-network-mcp-server
# Alternatively:
yarn add base-network-mcp-server
# Or via pnpm:
pnpm add base-network-mcp-server

Illustrative Use Case

The following example leverages the StreamTransport mechanism to establish a direct communication channel between an MCP client and the server instance:

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamTransport } from '@modelcontextprotocol/sdk/client/stream.js';
import { BaseMcpServer } from 'base-network-mcp-server';

// Fabricate a bi-directional stream transport instance for both parties
const clientTransport = new StreamTransport();
const serverTransport = new StreamTransport();

// Link the streams to enable data flow between them
clientTransport.readable.pipeTo(serverTransport.writable);
serverTransport.readable.pipeTo(clientTransport.writable);

const client = new Client(
  {
    name: 'MyClient',
    version: '0.1.0',
  },
  {
    capabilities: {},
  }
);

// Instantiate and initialize the Base MCP server instance
const server = new BaseMcpServer({
  providerUrl: 'https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY',
  privateKey: 'your_private_key_here',
});

// Establish connections between the client/server and their respective transports
await server.connect(serverTransport);
await client.connect(clientTransport);

// Invoke a tool function
const output = await client.callTool({
  name: 'execute_linguistic_instruction',
  arguments: {
    instruction_text: 'Determine the current holding status for my designated repository',
  },
});

console.log(output);
// Expected output format example:
// {
//   "success": true,
//   "message": "Balance for repository \"default\": 1.5 ETH",
//   "balance": "1.5",
//   "wallet": "default"
// }

Sample Conversational Directives

Once correctly deployed, users can issue directives such as:

"Generate a fresh repository intended for long-term asset storage"
"Ascertain the current quantity of Ether held"
"What is the current holding status of my storage repository?"
"Transfer 0.1 Ether to the destination address 0x1234567890123456789012345678901234567890"
"Move 0.5 Ether from my storage account to address 0xABCD..."

Safety Directives

Given that this implementation directly engages with live ledger networks and handles confidential private keys:

Key Confidentiality: Ensure private keys are stored securely and must never be committed into source control repositories.
Staging First Protocol: Always commence operations using the Base Sepolia test network prior to deploying to the main production ledger.
Transaction Verification: Mandatorily validate all transfer parameters before authorizing network submission.
Exception Management: Implement resilient error handling mechanisms to manage potential network instability or RPC failures.
Request Quota Awareness: Maintain vigilance regarding API consumption limits when executing high-frequency interactions.

WIKIPEDIA: Tron (stylized as TRON) is a decentralized, proof-of-stake blockchain with smart contract functionality. The cryptocurrency native to the blockchain is known as Tronix (TRX). It was founded in March 2014 by Justin Sun and, since 2017, has been overseen and supervised by the TRON Foundation, a non-profit organization in Singapore, established in the same year. It is open-source software. Tron was originally an Ethereum-based ERC-20 token, which switched protocol to its own blockchain in 2018. On some cryptocurrency wallets, users can't withdraw their funds until they have enough amount for the network fee. Tron has been criticised for enabling organized crime, with The Wall Street Journal stating in 2025 that it is a "popular channel for crypto’s criminal fraternity to move funds" and responsible for "more than half of all illegal crypto activity" in 2024, with the United Nations Office on Drugs and Crime calling it a “preferred choice for crypto money launderers” in Asia.

== History == Tron was founded by Justin Sun in 2017. The TRON Foundation was established in July 2017 in Singapore. The TRON Foundation raised $70 million in 2017 through an initial coin offering (ICO) shortly before China outlawed the digital tokens. The testnet, Blockchain Explorer, and Web Wallet were all launched by March 2018. TRON Mainnet launched shortly afterward in May 2018, marking the Odyssey 2.0 release as a technical milestone for TRON. In June 2018, TRON switched its protocol from an ERC-20 token on top of Ethereum to an independent peer-to-peer network. On 25 July 2018, the TRON Foundation announced it had finished the acquisition of BitTorrent, a peer-to-peer file sharing service. Upon this acquisition, in August 2018, BitTorrent Founder Bram Cohen also disclosed that he was leaving the company to found a separate cryptocurrency, Chia. By January 2019, TRON had a total market cap of about $1.6 bn. Despite this market performance, some authors viewed TRON as a typical case of the complex and disordered nature of cryptocurrencies. In February 2019, after being acquired by TRON Foundation, BitTorrent started its own token sale based on the TRON network. In late 2021, Justin Sun resigned as CEO of the TRON Foundation, which was subsequently reorganized as a DAO. In March 2023, Sun and Tron were sued by the U.S. Securities and Exchange Commission (SEC) for selling unregistered securities related to the sale and promotion of Tronix (TRX) and BitTorrent (BBT) tokens; the SEC alleged that Sun and Tron had engaged in wash trading in the secondary market for TRX in order to buoy its price. $31 million of proceeds were generated through thousands of Tronix trades between two accounts Sun controlled. Eight celebrities, including Akon, Ne-Yo, Austin Mahone, Soulja Boy, Lindsay Lohan, Jake Paul and Lil Yachty, were charged with promoting these cryptocurrencies without disclosing that they were sponsored, with all those other than Soulja Boy, and Mahone settling with t