Datai MCP Server

A powerful Model Context Protocol (MCP) server for interacting with DeFi protocols and blockchain data through the Datai API. This server provides comprehensive tools for analyzing DeFi positions, balances, and protocol interactions across multiple blockchain networks.

Description

Datai MCP is a TypeScript-based MCP server that enables seamless interaction with DeFi protocols through AI-powered interfaces. It provides a comprehensive set of tools for DeFi analysis, portfolio management, and cross-chain data aggregation using the Datai API.

Features

• 8 Comprehensive DeFi Tools: Complete coverage of DeFi positions and balance analysis
• Multi-Chain Support: Ethereum, Arbitrum, Polygon, Avalanche, BSC, Base, Optimism
• Real-time Data: Live DeFi protocol data from Datai API
• Debug Mode: Intelligent data truncation for development and testing
• MCP Compliant: Full TypeScript implementation with proper logging
• Error Handling: Comprehensive error management and validation
• Performance Monitoring: Request timing and execution tracking

Available Tools

| Tool | Description | Parameters | | ------------------------------ | -------------------------------------------------- | -------------------- | | get_all_defi_positions | Get all DeFi positions across all supported chains | wallet | | get_defi_by_chain | Get DeFi positions for a specific blockchain | wallet, chain | | get_defi_multi_chains | Get DeFi positions across multiple chains | wallet, chains[] | | get_defi_by_protocol | Get DeFi positions for a specific protocol | wallet, protocol | | get_defi_balances_by_chain | Get DeFi protocol balances by chain | wallet, chain | | get_overall_balance_all_c | Get overall balance across all chains | wallet | | get_overall_balance_by_chain | Get overall balance for a specific chain | wallet, chain | | get_wallet_balances_by_chain | Get token balances for a specific chain | wallet, chain |

Supported Chains

• eth - Ethereum
• arb - Arbitrum
• matic - Polygon
• avax - Avalanche
• bsc - Binance Smart Chain
• base - Base
• op - Optimism

Supported Protocols

• Uniswap (V2, V3, V4)
• Aave (V2, V3)
• Compound
• Balancer
• SushiSwap
• Curve
• MakerDAO
• And many more...

Integration with Cursor

To connect to the MCP server from Cursor:

1. Open Cursor and go to Settings (gear icon in the top right)
2. Click on "MCP" in the left sidebar
3. Click "Add new global MCP server"
4. Enter the following configuration:

Local Development Configuration

{
  "mcpServers": {
    "datai-fastmcp-server-local": {
      "command": "node",
      "args": ["/path/to/your/datai-mcp/dist/index.js"],
      "env": {
        "DATAI_API_KEY": "your_api_key_here",
        "DATAI_LIMIT": "1",
        "DATAI_DEBUG_TRUNCATE": "true",
        "DATAI_CONNECTION_TIMEOUT": "130000",
        "DATAI_RESPONSE_TIMEOUT": "90000",
        "PORT": "3099",
        "DEBUG": "true",
        "NODE_ENV": "production",
        "MCP_DISABLE_PINGS": "true"
      }
    }
  }
}

Production Configuration (NPX - Coming Soon)

{
  "mcpServers": {
    "datai-fastmcp-server": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "DATAI_API_KEY": "your_api_key_here",
        "DATAI_LIMIT": "1",
        "DATAI_DEBUG_TRUNCATE": "true",
        "DATAI_CONNECTION_TIMEOUT": "130000",
        "DATAI_RESPONSE_TIMEOUT": "90000",
        "PORT": "3099",
        "DEBUG": "true",
        "NODE_ENV": "production",
        "MCP_DISABLE_PINGS": "true"
      }
    }
  }
}

Environment Variables

| Variable | Description | Default | Required | | -------------------------- | ------------------------------------ | -------- | -------- | | DATAI_API_KEY | Your Datai API key | - | ✅ Yes | | DATAI_LIMIT | API response limit (1-100) | 10 | No | | DATAI_DEBUG_TRUNCATE | Enable data truncation for debugging | false | No | | DATAI_CONNECTION_TIMEOUT | Connection timeout in ms | 130000 | No | | DATAI_RESPONSE_TIMEOUT | Response timeout in ms | 90000 | No | | DEBUG | Enable debug logging | false | No | | PORT | Server port | 3099 | No |

Debug Mode

When DATAI_DEBUG_TRUNCATE is set to "true", the server will intelligently truncate API responses to prevent memory issues during development and testing. This provides:

• Minimal Output: Reduces 1000+ line responses to ~15 lines
• Structure Preservation: Shows data types, array lengths, object keys
• Sample Data: First few items/values for verification
• Clear Status: Indicates when truncation is active

Example truncated output:

{
  "__debug_truncated": true,
  "__summary": {
    "type": "array",
    "length": 25,
    "item_types": ["object"],
    "first_item_keys": ["chain", "name", "commonName", "logo", "site"]
  },
  "__sample_data": {
    "chain": "eth",
    "name": "uniswap3",
    "commonName": "Uniswap V3"
  },
  "__message": "✅ Tool working - data truncated for debugging"
}

Integration with Claude Desktop

To connect to the MCP server from Claude Desktop:

1. Open Claude Desktop and go to Settings
2. Click on "Developer" in the left sidebar
3. Click the "Edit Config" Button
4. Add the configuration to the claude_desktop_config.json file
5. Save the file and restart Claude Desktop

Local Development

Prerequisites

• Node.js v18 or higher
• npm or yarn
• Datai API key

Quick Start

1. Clone the repository:

git clone https://github.com/Datai-Network/datai-fastmcp-server.git

cd datai-fastmcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Configure your MCP client with the local configuration shown above

5. Start using the tools in your MCP-compatible client!

Available Scripts

• npm run build: Build the TypeScript project
• npm run dev: Build and watch for changes
• npm run test: Run test suite (coming soon)

API Integration

This server integrates with the Datai API to provide real-time DeFi data:

• Base URL: https://api-v1.mymerlin.io
• Authentication: API key-based
• Rate Limiting: Configurable via DATAI_LIMIT
• Timeout Handling: Configurable connection and response timeouts
• Error Handling: Comprehensive error transformation and logging

Security Considerations

• API Key Protection: Never commit API keys to version control
• Environment Variables: Use secure environment variable management
• Input Validation: All inputs are validated using Zod schemas
• Error Sanitization: Sensitive information is filtered from error messages
• Timeout Protection: Prevents hanging requests with configurable timeouts

Contributing

We welcome contributions! Please ensure:

1. All code follows TypeScript best practices
2. Comprehensive error handling is implemented
3. Input validation is present for all tools
4. Logging is FastMCP compliant
5. Tests are included for new features

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support and questions:

• Create an issue in the GitHub repository
• Check the documentation for common solutions
• Review the debug output when DATAI_DEBUG_TRUNCATE=true