Ankr API MCP Server

MCP (Model Context Protocol) server for blockchain data through the Ankr API.

Overview

The Ankr MCP Server fetches on-chain data via the Ankr API. It implements the MCP to allow LLMs to query blockchain data across 20+ chains.

Features

The server provides 21 tools across all Ankr Advanced API categories:

Token Operations

• Get Token Balances (get_token_balances): Gets all token balances for a wallet on a specific blockchain
• Get Currencies (get_currencies): Lists all available currencies on a blockchain
• Get Token Price (get_token_price): Gets current USD price for any token
• Get Token Holders (get_token_holders): Lists holder addresses for a token
• Get Token Holders Count (get_token_holders_count): Gets historical holder count data
• Get Token Transfers (get_token_transfers): Gets token transfer history for addresses
• Get Token Price History (get_token_price_history): Gets historical price data over time
• Explain Token Price (explain_token_price): Breaks down how a token price is derived

NFT Operations

• Get NFTs by Owner (get_nfts_by_owner): Gets all NFTs owned by a wallet
• Get NFT Metadata (get_nft_metadata): Gets metadata (name, image, traits) for a specific NFT
• Get NFT Holders (get_nft_holders): Gets all holders of an NFT collection
• Get NFT Transfers (get_nft_transfers): Gets NFT transfer history

Query Operations

• Get Blockchain Stats (get_blockchain_stats): Gets chain statistics (transactions, block time, etc.)
• Get Blocks (get_blocks): Gets full block data for a block range
• Get Logs (get_logs): Gets historical event log data
• Get Transactions by Hash (get_transactions_by_hash): Looks up a transaction by hash
• Get Transactions by Address (get_transactions_by_address): Gets all transactions for an address
• Get Interactions (get_interactions): Lists all chains a wallet has interacted with
• Get Account Balance Historical (get_account_balance_historical): Gets balance at a past block height
• Get Internal Transactions by Block (get_internal_transactions_by_block): Gets internal txns in a block
• Get Internal Transactions by Parent Hash (get_internal_transactions_by_parent_hash): Gets internal txns from a parent tx

Installation

npm install @akki91/ankr-mcp

Usage

Environment Setup

Set your ANKR API token by logging into ANKR api docs portal.

export ANKR_API_TOKEN=your_api_token_here

Running the Server

The server can be run directly from the command line:

npx @akki91/ankr-mcp

Usage with LLM Tools

This server implements the Model Context Protocol (MCP), which allows it to be used as a tool provider for compatible AI models.

Integration with AI Models

To integrate this server with AI applications that support MCP, add the following to your app's server configuration:

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

Integrating Ankr MCP Tools in Claude Desktop

Follow the instructions below to update your settings and ensure that your MCP server is available within Claude Desktop.

Step 1: Access Settings in Claude Desktop

1. Launch Claude Desktop.
2. From the main menu, navigate to Settings.

Step 2: Update Developer Settings

1. Open the Developer Settings.
2. Edit the configuration file that contains your MCP server definitions.
3. If MCP servers are already listed, append your Ankr MCP configuration to the existing list. Otherwise, copy and paste the entire above configuration for the Ankr MCP server.

Step 3: Restart Claude Desktop

1. Close the Developer Settings menu.
2. Restart Claude Desktop to apply the changes.

Step 4: Verify Integration

1. Once Claude Desktop has restarted, click on the Tools Icon located just below the chat prompt.
2. Verify that the list of tools provided by the Ankr MCP server is visible and accessible.

By following these steps, your Ankr MCP configuration should now be integrated into Claude Desktop, allowing you to access its tools directly through the interface.

Sample Chat Prompts

Here are example prompts you can use with this MCP server in Claude or any compatible AI:

Token Queries

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 Queries

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 & Transaction Queries

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?

Development

Building from Source

# 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

Running Tests

npm test

Debug Mode

Debugging for this project is supported using MCP Inspector

npm run debug

Sources

This project is inspired from list of servers created here