Skip to main content
Glama
akki91
by akki91

MCP Badge

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 ab

  • Währungen abrufen (get_currencies): Listet alle verfügbaren Währungen auf einer Blockchain auf

  • Token-Preis abrufen (get_token_price): Ruft den aktuellen USD-Preis für einen beliebigen Token ab

  • Token-Inhaber abrufen (get_token_holders): Listet Inhaber-Adressen für einen Token auf

  • Anzahl der Token-Inhaber abrufen (get_token_holders_count): Ruft historische Daten zur Anzahl der Inhaber ab

  • Token-Transfers abrufen (get_token_transfers): Ruft die Token-Transferhistorie für Adressen ab

  • Historischen Token-Preis abrufen (get_token_price_history): Ruft historische Preisdaten im Zeitverlauf ab

  • Token-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 befinden

  • NFT-Metadaten abrufen (get_nft_metadata): Ruft Metadaten (Name, Bild, Eigenschaften) für ein bestimmtes NFT ab

  • NFT-Inhaber abrufen (get_nft_holders): Ruft alle Inhaber einer NFT-Kollektion ab

  • NFT-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 ab

  • Logs abrufen (get_logs): Ruft historische Ereignis-Logdaten ab

  • Transaktionen nach Hash abrufen (get_transactions_by_hash): Sucht eine Transaktion anhand ihres Hashes

  • Transaktionen nach Adresse abrufen (get_transactions_by_address): Ruft alle Transaktionen für eine Adresse ab

  • Interaktionen abrufen (get_interactions): Listet alle Chains auf, mit denen eine Wallet interagiert hat

  • Historisches Kontoguthaben abrufen (get_account_balance_historical): Ruft das Guthaben zu einer vergangenen Blockhöhe ab

  • Interne Transaktionen nach Block abrufen (get_internal_transactions_by_block): Ruft interne Transaktionen in einem Block ab

  • Interne Transaktionen nach übergeordnetem Hash abrufen (get_internal_transactions_by_parent_hash): Ruft interne Transaktionen von einer übergeordneten Transaktion ab

Installation

npm install @akki91/ankr-mcp

Verwendung

Umgebungseinrichtung

Legen Sie Ihr ANKR-API-Token fest, indem Sie sich im ANKR-API-Dokumentationsportal anmelden.

export ANKR_API_TOKEN=your_api_token_here

Server ausführen

Der Server kann direkt über die Befehlszeile ausgeführt werden:

npx @akki91/ankr-mcp

Verwendung 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

  1. Starten Sie Claude Desktop.

  2. Navigieren Sie im Hauptmenü zu Settings.

Schritt 2: Entwicklereinstellungen aktualisieren

  1. Öffnen Sie die Developer Settings.

  2. Bearbeiten Sie die Konfigurationsdatei, die Ihre MCP-Serverdefinitionen enthält.

  3. 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

  1. Schließen Sie das Menü Developer Settings.

  2. Starten Sie Claude Desktop neu, um die Änderungen zu übernehmen.

Schritt 4: Integration überprüfen

  1. Sobald Claude Desktop neu gestartet wurde, klicken Sie auf das Tools-Symbol direkt unter dem Chat-Eingabefeld.

  2. Ü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 build

Tests ausführen

npm test

Debug-Modus

Das Debugging für dieses Projekt wird durch den MCP Inspector unterstützt.

npm run debug

Quellen

Dieses Projekt wurde von der Liste der Server inspiriert, die hier erstellt wurden.

Verifizierung

Available Tools

1 tool
get_token_balances_on_networkB

Gets all token balances for a given address on a specific network

ParametersJSON Schema
NameRequiredDescriptionDefault
addressYesThe address to check token balances for
networkYesThe blockchain network (e.g., "ethereum", "base")

TDQS

B3.1/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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. 1 tool updatev1.0.0
    • First observedget_token_balances_on_network

TDQS

B3.2/5.0

Scored across 1 tool

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count2/5

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.

Completeness1/5

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

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers