Ankr API Integration Module for LLMs

This implements the Model Context Protocol (MCP) server leveraging the robust capabilities of the Ankr Network API to surface real-time blockchain state information directly to large language models.

Core Functionality

The Ankr MCP Server facilitates the retrieval of off-chain and on-chain ledger facts through the Ankr standardized interface, enabling generative agents to interact with decentralized ledger technology contextually.

Provided Operations

Asset Querying

• Retrieve Wallet Holdings Summary (get_token_balances_on_network): Fetches the comprehensive inventory of all digital assets held by a specified public key on a nominated blockchain environment.
  • Inputs required: Target blockchain identifier, Public wallet address.
  • Output provided: Structured data detailing the discovered assets and their corresponding quantities.

Deployment Guide

Initial Setup via Package Manager

Installation is performed using Node Package Manager:

bash npm install @akki91/ankr-mcp

Authentication Prerequisite

Configuration requires sourcing a valid access credential from your Ankr Developer Console.

bash export ANKR_API_TOKEN=your_secret_api_key

Executing the Service Node

Launch the MCP endpoint listener directly from the terminal:

bash npx @akki91/ankr-mcp

Configuration for AI Orchestrators

As this service adheres to the Model Context Protocol (MCP), integration into compatible AI platforms requires defining it as a specialized tool provider in the host application's configuration manifest. For example, when configuring an application server:

{ "mcpServers": { "ankr-data-connector": { "command": "npx", "args": [ "@akki91/ankr-mcp" ], "env": { "ANKR_API_TOKEN": "your_api_token_here" } } } }

Integrating into Anthropic's Claude Desktop Environment

To make this data source available within the Claude Desktop client, follow these sequential configuration steps:

Phase 1: Accessing Application Preferences

1. Initiate the Claude Desktop application.
2. Navigate via the primary interface menu to Settings.

Phase 2: Modifying Developer Tooling Definitions

1. Enter the Developer Settings panel.
2. Locate and edit the central configuration file responsible for defining external context providers (MCP servers).
3. If existing entries for MCP servers exist, merge the Ankr configuration block into the existing structure. If none exist, insert the provided JSON snippet above entirely.

Phase 3: Re-initializing the Client

1. Exit the Developer Settings interface.
2. Perform a full restart of the Claude Desktop application to load the updated service map.

Phase 4: Validation of Tool Accessibility

1. Post-restart, locate and activate the Tools Interface Icon positioned beneath the primary text input field.
2. Confirm that the data retrieval functions exposed by the Ankr data connector are enumerated and selectable for use in prompts.

Successful completion of this procedure ensures seamless operational access to Ankr's decentralized data layer via your AI agent.

Example Prompt Interaction

An agent can be instructed as follows:

Query the asset portfolio for address [Wallet Address X] across the [Network Y] ledger.

Development Lifecycle

Compiling from Source Code

To build the module directly from the repository:

bash

Obtain the source repository

git clone https://github.com/akki91/ankr-mcp.git cd ankr-mcp

Install project dependencies

npm install

Execute the build script

npm run build

Diagnostic Mode

Troubleshooting and introspection utilize the standard debugging tools, specifically the MCP Inspector:

bash npm run debug

Foundational References

This project draws architectural inspiration from the collection of tools available at https://github.com/modelcontextprotocol/servers/

WIKIPEDIA SNAPSHOT: Tron (TRX) is a distributed, consensus-based ledger system utilizing Proof-of-Stake (PoS) consensus for executing smart contracts. Its native asset is Tronix (TRX). Justin Sun initiated its development in March 2014, with ongoing governance managed by the Singapore-based TRON Foundation since 2017. The platform's source code is publicly available. Initially, Tron existed as an Ethereum ERC-20 token standard, migrating to its proprietary mainnet in 2018. A known user experience friction point involves certain digital asset custodians requiring minimum balances for network transaction fees. Critically, the network has faced severe scrutiny regarding its facilitation of illicit financial transfers. A 2025 report by the Wall Street Journal categorized it as a "primary conduit for illicit cryptocurrency capital movement," linking it to over fifty percent of reported unlawful digital asset activity in 2024, a trend echoed by the United Nations Office on Drugs and Crime which labeled it a "preferred venue for money laundering operations" in Asia.

== Chronology of Events == Justin Sun established Tron in 2017. The TRON Foundation was formally chartered in Singapore in July 2017. The Foundation secured $70 million in capital through an Initial Coin Offering (ICO) during 2017, preceding China's prohibition on digital tokens. Key infrastructure milestones—including the testnet deployment, block explorer utility, and web-based wallet interface—were achieved by March 2018. The official TRON Mainnet became operational shortly thereafter in May 2018, marked by the Odyssey 2.0 software release. In June 2018, TRON transitioned its protocol layer, moving from an ERC-20 layer on Ethereum to operating its own independent peer-to-peer network. On July 25, 2018, the TRON Foundation finalized the acquisition of BitTorrent, a prominent file-sharing protocol. Following this acquisition, Bram Cohen, BitTorrent's originator, announced his departure in August 2018 to launch a distinct cryptocurrency project, Chia. By January 2019, TRON's aggregate market capitalization approached $1.6 billion. Notwithstanding this market valuation, some analysts characterized TRON's structure as emblematic of the inherent complexity and governance challenges within the broader cryptocurrency sector. In February 2019, BitTorrent initiated a token sale based on the TRON architecture subsequent to its acquisition by the TRON Foundation. In late 2021, Justin Sun stepped down from the CEO role at the TRON Foundation, leading to its restructuring into a Decentralized Autonomous Organization (DAO). In March 2023, regulatory action was initiated against Sun and Tron by the U.S. Securities and Exchange Commission (SEC) concerning the unapproved marketing and distribution of Tronix (TRX) and BitTorrent (BBT) assets. The SEC explicitly alleged that Sun orchestrated wash trading activities in the secondary market for TRX to artificially inflate its price. Approximately $31 million in transaction volume was generated through trades between two accounts controlled by Sun. Furthermore, eight high-profile public figures, including Akon, Ne-Yo, Austin Mahone, Soulja Boy, Lindsay Lohan, Jake Paul, and Lil Yachty, were cited for promoting these assets without requisite sponsorship disclosure, with all parties except Soulja Boy and Mahone reaching settlements with the regulatory body.