Aapi MCP Server

🚀 Ankr Advanced API MCP Server ⚡

This is a server based on the Model Context Protocol (MCP), providing tools for interacting with Ankr's advanced APIs. It enables AI models to access blockchain data and perform various operations.

🚀 Quick Start

Tools

• getAccountBalance: Retrieve the token balances of any address or ENS name across multiple chains.

  • Parameters:
    • address: Ethereum address (0x...) or ENS name (*.eth)
    • blockchains (optional): An array of specific blockchains to query. If not provided, all supported chains will be checked.

• getTokenPrice: Get the current price of any token (native or ERC20) on supported chains.

  • Parameters:
    • blockchain: Blockchain network (eth, bsc, polygon, etc.)
    • contractAddress (optional): The contract address of the token. Leave it blank to get the native token.

Supported Blockchains

• Mainnets: Ethereum, BSC, Polygon, Arbitrum, Avalanche, Base, Fantom, Gnosis, Linea, Optimism, etc.
• Testnets: Ethereum Sepolia, Ethereum Holesky, Base Sepolia, Avalanche Fuji, etc.

📦 Installation

Prerequisites

1. Ankr API Key
   • Create a free account at ankr.com/rpc.

Configure Cursor 🖥️

1. Open Cursor settings.
2. Navigate to Features > MCP Server.
3. Click the "+ Add New MCP Server" button.
4. Fill in the following information:
   • Name: Enter a nickname for the server (e.g., "Ankr AAPI MCP").
   • Type: Select the "Command" type.
   • Command: env ANKR_API_KEY=<YOUR_KEY> npx -y @asphere/aapi-mcp-server

Use with Claude Desktop

{
  "mcpServers": {
    "aapi": {
      "command": "npx",
      "args": ["-y", "@asphere/aapi-mcp-server"],
      "env": {
        "ANKR_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

💻 Usage Examples

Local Development

Install Dependencies

pnpm i

Run the Local SSE Server

export ANKR_API_KEY="YOUR-ANKR-KEY"
pnpm dev:sse

Remote Server

In remote mode, the service creates an isolated MCP server instance for each connection, enabling secure and isolated access over the internet. Each connection requires an apiKey in the URL path for authentication with Ankr's advanced APIs.

Asphere-Managed AAPI MCP Remote Server

The managed version is available at https://aapi-mcp-server.asphere.network/.

https://aapi-mcp-server.asphere.network/{ANKR-API-KEY}/sse

Local Development for Remote Server

# Start the remote server
pnpm dev:remote

# Connect using localhost
http://localhost:3001/{apiKey}/sse

Deployment

After deployment, MCP clients can connect using the following configuration:

type: sse
url: https://your-remote-url.com/{apiKey}/sse