MCP4Meme 🚀

FastMCP demo server for meme-related functionality.

Features

Bonding Curve & Token Analysis

• Bonding curve progress: Track token graduation status (0-100%)
• Migration tracking: Monitor token migration from bonding curve to DEX
• Token lifecycle: Identify tokens approaching "graduation" threshold

Trading & Market Data

• Latest trades: Real-time trading activity and transaction history
• Price data: Current USD and BNB prices with market cap
• Volume analytics: Trading volume statistics with OHLCV data
• Market trends: Price movements and trading patterns

Trader & Liquidity Analysis

• Top traders: Identify high-volume traders and "smart money"
• Liquidity events: Track liquidity additions/removals
• Trading behavior: Analyze trader patterns and P&L

Discovery & Search

• Progress search: Find tokens by bonding curve completion (e.g., 90-95%)
• Trending tokens: Discover hot tokens by volume, trades, or progress
• Market scanning: Search across Four.meme ecosystem

Demo Tools (Legacy)

• Calculator tools: add(), multiply()
• Greeting tool: get_greeting(name)

Quick Start

Local Development

# Install dependencies
uv pip install -r requirements.txt

# Configure API key (optional - uses mock data without key)
cp .env.example .env
# Edit .env and add your Bitquery API key

# Run server
python mcp_server.py

# Test with FastMCP inspector
fastmcp dev mcp_server.py

Docker Usage

# Build image
docker build -t mcp4meme .

# STDIO mode (for MCP clients)
docker run -it mcp4meme

# With API key
docker run -it -e BITQUERY_API_KEY=your_key_here mcp4meme

# HTTP mode (for web access)
docker run -p 8000:8000 mcp4meme python mcp_server.py --http

# Using docker-compose
docker-compose up mcp4meme
docker-compose --profile http up mcp4meme-http

DeepChat Integration

With API key (real data):

{
  "mcpServers": {
    "mcp4meme": {
      "command": "docker",
      "args": ["run", "-i", "mcp4meme"],
      "env": {
        "BITQUERY_API_KEY": "your_bitquery_api_key_here"
      }
    }
  }
}

Without API key (mock data):

{
  "mcpServers": {
    "mcp4meme": {
      "command": "docker",
      "args": ["run", "-i", "mcp4meme"]
    }
  }
}

Available Tools

Bonding Curve & Token Analysis

• get_bonding_curve_progress(token_address: str) - Get token bonding curve progress percentage
• get_token_migration_status(token_address: str) - Check token migration status from bonding curve to DEX

Trading & Market Data

• get_latest_trades(token_address: str, limit: int = 10) - Get latest trading records
• get_token_price_usd(token_address: str) - Get current USD price for a token
• get_trading_volume(token_address: str, timeframe: str = "24h") - Get trading volume statistics

Trader & Liquidity Analysis

• get_top_traders(token_address: str, limit: int = 10, timeframe: str = "24h") - Get top traders by volume
• get_liquidity_events(token_address: str, limit: int = 10) - Get liquidity-related events

Discovery & Search

• search_tokens_by_progress(min_progress: float = 90.0, max_progress: float = 95.0, limit: int = 20) - Search tokens by bonding curve progress
• get_trending_tokens(timeframe: str = "24h", sort_by: str = "volume", limit: int = 10) - Get trending tokens

Demo Tools (Legacy)

• add(a: int, b: int) -> int - Add two numbers
• multiply(a: int, b: int) -> int - Multiply two numbers
• get_greeting(name: str) -> str - Get a personalized greeting

Resources

• config://mcp4meme - Server configuration and features
• config://fourmeme-proxy - Four.meme proxy contract configuration

API Configuration

The server uses the Bitquery API to fetch blockchain data. To use real data:

1. Get a free API key from Bitquery.io
2. Copy .env.example to .env
3. Add your API key: BITQUERY_API_KEY=your_key_here

Without an API key, the server returns mock data for testing.