keeta-top-holders-tracker MCP Server

MCP (Model Context Protocol) server for querying keeta-top-holders-tracker blockchain subgraph data using natural language and Cypher queries.

🚀 Quick Start

Installation

npx @graphi-ai/mcp-keeta-top-holders-tracker

Usage in Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "keeta-top-holders-tracker": {
      "command": "npx",
      "args": ["mcp-keeta-top-holders-tracker"]
    }
  }
}

That's it! No database credentials or configuration needed. 🎉

🔧 Configuration

The MCP server comes pre-configured with the correct API endpoint. No environment variables are required for basic operation.

Optional Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | SUBGRAPH_ID | Override the subgraph ID (advanced users only) | 279f267c-9ad2-41dd-8f5b-4f54b9e1651a |

📡 Features

• 🔍 Natural Language Queries: Ask questions like "Show me recent large transfers"
• ⚡ Cypher Query Execution: Execute custom Cypher queries with automatic subgraph filtering
• 🛡️ Data Isolation: Automatic subgraph_id filtering ensures you only see relevant data
• 🌐 Dynamic Schema: Fetches real-time schema information from the chat interface
• 🔒 Secure: No need to manage database credentials - everything goes through the chat interface API

🎯 Available Tools

cypher_query

Execute Cypher queries against the keeta-top-holders-tracker subgraph.

Parameters:

• query (string, required): Cypher query to execute
• params (object, optional): Query parameters

Example:

MATCH (t:Transfer) 
WHERE t.subgraph_id = $subgraph_id 
  AND t.value > 1000000000000000000 
RETURN t 
ORDER BY t.timestamp DESC 
LIMIT 10

📊 Subgraph Information

• Subgraph ID: 279f267c-9ad2-41dd-8f5b-4f54b9e1651a
• Network: base-mainnet
• Description: Real-time tracking of top 10 Keeta token holders behavior on Base chain, monitoring Transfer and Swap events

🔄 How It Works

1. Schema Fetching: Automatically fetches schema information from the chat interface API
2. Query Execution: Sends Cypher queries to the chat interface for execution
3. Data Filtering: Automatically adds subgraph_id filtering to ensure data isolation
4. Result Formatting: Returns properly formatted results for Claude to understand

🛠️ Development

Local Development

# Clone and install
git clone https://github.com/graphi-ai/mcp-keeta-top-holders-tracker.git
cd mcp-keeta-top-holders-tracker
npm install

# Build
npm run build

# Run locally
npm start

Configuration for Development

Create a .env file:

CHAT_INTERFACE_BASE_URL=http://localhost:8000
SUBGRAPH_ID=279f267c-9ad2-41dd-8f5b-4f54b9e1651a

🔍 Example Queries

Recent Transfers

MATCH (t:Transfer) 
WHERE t.subgraph_id = $subgraph_id 
RETURN t 
ORDER BY t.timestamp DESC 
LIMIT 20

Top Wallets by Activity

MATCH (w:Wallet) 
WHERE w.subgraph_id = $subgraph_id 
RETURN w.address, w.transaction_count 
ORDER BY w.transaction_count DESC 
LIMIT 10

Token Information

MATCH (token:Token) 
WHERE token.subgraph_id = $subgraph_id 
RETURN token.symbol, token.name, token.address

🚨 Important Notes

• Data Isolation: All queries must include WHERE n.subgraph_id = $subgraph_id for data isolation
• Automatic Filtering: The subgraph_id parameter is automatically added to your queries
• API Dependency: This server requires access to the GraphAI chat interface API
• No Direct DB Access: Queries are processed through the chat interface, not directly against the database

📞 Support

• Issues: GitHub Issues
• Documentation: GraphAI Documentation
• Chat Interface: Part of the GraphAI ecosystem

📄 License

MIT License - see LICENSE for details.

Powered by GraphAI 🚀