Ankr API MCP Server
Ankr API MCP-Server
MCP-Server (Model Context Protocol) für Blockchain-Daten über die Ankr-API.
Übersicht
Der Ankr MCP-Server ruft On-Chain-Daten über die Ankr-API ab. Er implementiert das MCP, damit LLMs Blockchain-Daten über mehr als 20 Chains hinweg abfragen können.
Related MCP server: Base Network MCP Server
Funktionen
Der Server bietet 21 Tools aus allen Kategorien der Ankr Advanced API:
Token-Operationen
Token-Guthaben abrufen (
get_token_balances): Ruft alle Token-Guthaben für eine Wallet auf einer bestimmten Blockchain abWährungen abrufen (
get_currencies): Listet alle verfügbaren Währungen auf einer Blockchain aufToken-Preis abrufen (
get_token_price): Ruft den aktuellen USD-Preis für einen beliebigen Token abToken-Inhaber abrufen (
get_token_holders): Listet Inhaber-Adressen für einen Token aufAnzahl der Token-Inhaber abrufen (
get_token_holders_count): Ruft historische Daten zur Anzahl der Inhaber abToken-Transfers abrufen (
get_token_transfers): Ruft die Token-Transferhistorie für Adressen abHistorischen Token-Preis abrufen (
get_token_price_history): Ruft historische Preisdaten im Zeitverlauf abToken-Preis erklären (
explain_token_price): Erläutert, wie ein Token-Preis zustande kommt
NFT-Operationen
NFTs nach Besitzer abrufen (
get_nfts_by_owner): Ruft alle NFTs ab, die sich im Besitz einer Wallet befindenNFT-Metadaten abrufen (
get_nft_metadata): Ruft Metadaten (Name, Bild, Eigenschaften) für ein bestimmtes NFT abNFT-Inhaber abrufen (
get_nft_holders): Ruft alle Inhaber einer NFT-Kollektion abNFT-Transfers abrufen (
get_nft_transfers): Ruft die NFT-Transferhistorie ab
Abfrage-Operationen
Blockchain-Statistiken abrufen (
get_blockchain_stats): Ruft Chain-Statistiken ab (Transaktionen, Blockzeit usw.)Blöcke abrufen (
get_blocks): Ruft vollständige Blockdaten für einen Blockbereich abLogs abrufen (
get_logs): Ruft historische Ereignis-Logdaten abTransaktionen nach Hash abrufen (
get_transactions_by_hash): Sucht eine Transaktion anhand ihres HashesTransaktionen nach Adresse abrufen (
get_transactions_by_address): Ruft alle Transaktionen für eine Adresse abInteraktionen abrufen (
get_interactions): Listet alle Chains auf, mit denen eine Wallet interagiert hatHistorisches Kontoguthaben abrufen (
get_account_balance_historical): Ruft das Guthaben zu einer vergangenen Blockhöhe abInterne Transaktionen nach Block abrufen (
get_internal_transactions_by_block): Ruft interne Transaktionen in einem Block abInterne Transaktionen nach übergeordnetem Hash abrufen (
get_internal_transactions_by_parent_hash): Ruft interne Transaktionen von einer übergeordneten Transaktion ab
Installation
npm install @akki91/ankr-mcpVerwendung
Umgebungseinrichtung
Legen Sie Ihr ANKR-API-Token fest, indem Sie sich im ANKR-API-Dokumentationsportal anmelden.
export ANKR_API_TOKEN=your_api_token_hereServer ausführen
Der Server kann direkt über die Befehlszeile ausgeführt werden:
npx @akki91/ankr-mcpVerwendung mit LLM-Tools
Dieser Server implementiert das Model Context Protocol (MCP), wodurch er als Tool-Anbieter für kompatible KI-Modelle verwendet werden kann.
Integration mit KI-Modellen
Um diesen Server in KI-Anwendungen zu integrieren, die MCP unterstützen, fügen Sie Folgendes zur Serverkonfiguration Ihrer App hinzu:
{
"mcpServers": {
"ankr-mcp": {
"command": "npx",
"args": [
"@akki91/ankr-mcp"
],
"env": {
"ANKR_API_TOKEN": "your_api_token_here"
}
}
}
}Integration der Ankr MCP-Tools in Claude Desktop
Befolgen Sie die unten stehenden Anweisungen, um Ihre Einstellungen zu aktualisieren und sicherzustellen, dass Ihr MCP-Server in Claude Desktop verfügbar ist.
Schritt 1: Einstellungen in Claude Desktop aufrufen
Starten Sie Claude Desktop.
Navigieren Sie im Hauptmenü zu Settings.
Schritt 2: Entwicklereinstellungen aktualisieren
Öffnen Sie die Developer Settings.
Bearbeiten Sie die Konfigurationsdatei, die Ihre MCP-Serverdefinitionen enthält.
Wenn bereits MCP-Server aufgelistet sind, fügen Sie Ihre Ankr MCP-Konfiguration der bestehenden Liste hinzu. Kopieren Sie andernfalls die gesamte oben genannte Konfiguration für den Ankr MCP-Server und fügen Sie sie ein.
Schritt 3: Claude Desktop neu starten
Schließen Sie das Menü Developer Settings.
Starten Sie Claude Desktop neu, um die Änderungen zu übernehmen.
Schritt 4: Integration überprüfen
Sobald Claude Desktop neu gestartet wurde, klicken Sie auf das Tools-Symbol direkt unter dem Chat-Eingabefeld.
Überprüfen Sie, ob die Liste der vom Ankr MCP-Server bereitgestellten Tools sichtbar und zugänglich ist.
Durch das Befolgen dieser Schritte sollte Ihre Ankr MCP-Konfiguration nun in Claude Desktop integriert sein, sodass Sie direkt über die Benutzeroberfläche auf die Tools zugreifen können.
Beispiel-Chat-Prompts
Hier sind Beispiel-Prompts, die Sie mit diesem MCP-Server in Claude oder einer anderen kompatiblen KI verwenden können:
Token-Abfragen
What are the token balances for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum?What's the current price of USDC on Ethereum?Show me the price history of ETH over the last 30 days.How many holders does the LINK token have on Ethereum?Show me recent token transfers for vitalik.eth on Polygon.NFT-Abfragen
What NFTs does 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 own?Get me the metadata for Bored Ape #1234.Who holds NFTs from the CryptoPunks collection?Show me recent NFT transfers for this wallet on Ethereum.Blockchain- & Transaktionsabfragen
What are the current stats for Ethereum and Polygon?Which blockchains has wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 interacted with?Look up transaction 0x1234abcd... and decode the logs.Show me the latest blocks on Arbitrum with transactions included.What were the internal transactions in Ethereum block 19000000?What was my wallet balance at block 17000000?Entwicklung
Aus dem Quellcode erstellen
# Clone the repository
git clone https://github.com/akki91/ankr-mcp.git
cd ankr-mcp
# Install dependencies
npm install
# Build the project
npm run buildTests ausführen
npm testDebug-Modus
Das Debugging für dieses Projekt wird durch den MCP Inspector unterstützt.
npm run debugQuellen
Dieses Projekt wurde von der Liste der Server inspiriert, die hier erstellt wurden.
Verifizierung
Available Tools
1 toolget_token_balances_on_networkB
Gets all token balances for a given address on a specific network
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | The address to check token balances for | |
| network | Yes | The blockchain network (e.g., "ethereum", "base") |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions 'Gets' which implies a read operation, but fails to describe critical behaviors such as rate limits, authentication requirements, error handling, or what 'all token balances' entails (e.g., pagination, format). This leaves significant gaps for an agent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that directly states the tool's purpose without any unnecessary words. It is appropriately sized and front-loaded, making it easy to parse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's low complexity (2 simple parameters) and no output schema, the description is minimally adequate but incomplete. It lacks details on behavioral aspects and output format, which are important for a read operation with no annotations to rely on.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, clearly documenting both parameters. The description adds no additional semantic context beyond what the schema provides, such as examples or constraints, so it meets the baseline for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Gets') and the resource ('all token balances for a given address on a specific network'), making the purpose specific and understandable. However, since there are no sibling tools mentioned, it cannot distinguish from alternatives, which prevents a perfect score.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, prerequisites, or exclusions. It simply states what the tool does without context for usage decisions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
v1.0.0- First observed
get_token_balances_on_network
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined and distinct by default.
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'get_token_balances_on_network' follows a clear verb_noun pattern.
One tool is too few for a server named 'Ankr API MCP Server', which suggests a broader API scope. This minimal set severely limits functionality and likely leaves significant gaps in coverage for blockchain-related operations.
The tool surface is severely incomplete for an API server. It only provides token balances, missing essential operations like querying transactions, network status, smart contract interactions, or other common blockchain API functions, leading to dead ends for agents.
Maintenance
Related MCP Connectors
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
MCP server giving AI agents one-connection access to crypto & DeFi data: DeFi protocol TVL, stableco
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that connects Claude for Desktop with blockchain functionality, allowing users to check balances and send tokens on EVM and Solana chains through natural language interactions.-
- AlicenseBqualityDmaintenanceAn MCP server that enables LLMs to perform blockchain operations on the Base network through natural language commands, including wallet management, balance checking, and transaction execution.454 npm3MIT
- AlicenseAqualityFmaintenanceAn MCP server that empowers AI agents to inspect any wallet’s balance and onchain activity across major EVM chains and Solana chain.39MIT
- AlicenseBqualityDmaintenanceAn MCP server providing comprehensive access to Ethereum blockchain data across 72+ networks via Etherscan's V2 API. It enables users to check balances, track transactions, analyze smart contracts, and monitor gas prices through natural language.2415 npm1MIT