Features Installation Documentation Tools Examples
πŸš€ MCP v0.1.0 - Production Ready

Professional Chiliz MCP Server

Advanced Model Context Protocol server for Chiliz blockchain integration. Real-time analytics, transaction capabilities, FanX DEX tools, and comprehensive fan token support.

23+
Tools
30+
Fan Tokens
5
API Integrations
100%
TypeScript
PSG
BAR
JUV
CITY
GAL

Powerful Features

Everything you need for Chiliz blockchain integration

Real-Time Analytics

Track prices, volumes, market cap, and token velocity with advanced statistical analysis

  • Live price feeds from CoinGecko
  • Historical charts & patterns
  • Whale transaction detection
  • Market sentiment analysis

Transaction Tools

Execute transactions directly through the MCP with full wallet management

  • Send CHZ & fan tokens
  • Token approvals
  • DEX swaps (1inch ready)
  • Gas optimization

Sports Correlation

Unique analysis correlating team performance with token prices

  • Match outcome predictions
  • Team performance tracking
  • League standings
  • Event impact analysis

Social Intelligence

Monitor social sentiment across multiple platforms

  • Twitter sentiment analysis
  • Reddit community tracking
  • Influencer monitoring
  • Trending detection

Blockchain Tools

Complete suite of blockchain interaction capabilities

  • Wallet balance checking
  • Transaction history
  • Block explorer integration
  • Smart contract calls

Performance

Optimized for speed with intelligent caching and rate limiting

  • Multi-tier caching
  • Rate limit protection
  • Parallel processing
  • WebSocket support
πŸ”„ DEX Integration

FanX DEX Integration & Liquidity Tools

Tools for interacting with FanX DEX liquidity pools and trading pairs

πŸ’§

Liquidity Pools

  • Real-time pool analytics
  • TVL and volume tracking
  • APY calculations
  • Impermanent loss monitoring
πŸ”

Smart Routing

  • Optimal swap paths
  • Multi-hop routing
  • Price impact analysis
  • Slippage protection
πŸ“Š

Pool Analytics

  • Historical TVL charts
  • Fee tracking
  • Top providers list
  • Yield optimization
⚑

LP Management

  • Add/remove liquidity
  • Position tracking
  • Rewards claiming
  • Auto-compound options

Why Choose Chiliz MCP?

Superior features compared to other blockchain MCPs

βœ…

Transaction Ready

Not just read-only - execute real transactions

βœ…

Sports Specific

Tailored for fan token ecosystem

βœ…

Production Ready

Error handling, caching, rate limiting

βœ…

Type Safe

100% TypeScript with strict typing

βœ…

Multi-Source Data

CoinGecko, RPC, Social APIs integrated

βœ…

Advanced Analytics

Whale tracking, velocity, patterns

Quick Installation

Get started with Chiliz MCP in minutes

1

Clone Repository

git clone https://github.com/yourusername/chiliz-mcp.git
cd chiliz-mcp
2

Install Dependencies

npm install
3

Configure Environment

cp .env.example .env
# Edit .env with your configuration

NETWORK=mainnet
CHILIZ_RPC_URL=https://spicy-rpc.chiliz.com/
COINGECKO_API_KEY=your_api_key_here
PRIVATE_KEY=your_wallet_private_key  # Optional, for transactions
4

Build & Run

npm run build
npm start

Alternative Installation Methods

Docker

docker-compose up -d

NPM Global

npm install -g chiliz-mcp

Technical Documentation

Complete API reference and usage guide

Architecture Overview

Chiliz MCP follows a modular architecture with clear separation of concerns:

MCP Server Layer

Handles tool registration and request routing

Tools Layer

23+ specialized tools for different operations

API Clients Layer

CoinGecko, Chiliz RPC, Social APIs

Utilities Layer

Caching, rate limiting, error handling

Key Components

Price Tools

Real-time and historical price data

Wallet Tools

Balance checking and management

Transaction Tools

Send, approve, and swap tokens

Analytics Tools

Advanced market analysis

Available Tools

Price Tools

get_fan_token_price GET
Get current price and market data for a fan token
{
  "symbol": "PSG"  // Token symbol (e.g., PSG, BAR, JUV)
}
get_market_chart GET
Get historical price chart data
{
  "symbol": "PSG",
  "days": 7  // Number of days (1-365)
}

Transaction Tools

send_tokens POST
Send CHZ or fan tokens (requires PRIVATE_KEY)
{
  "to": "0x742d35Cc...",      // Recipient address
  "amount": "100",             // Amount to send
  "token": "PSG"               // Token symbol (optional, defaults to CHZ)
}

Analytics Tools

detect_whale_trades GET
Detect large transactions on the network
{
  "minValueUSD": 100000,  // Minimum USD value
  "blockRange": 100       // Blocks to scan
}

Usage Examples

Basic Price Check

import { Client } from '@modelcontextprotocol/sdk/client';

const client = new Client();
await client.connect(transport);

// Get PSG token price
const result = await client.callTool('get_fan_token_price', {
  symbol: 'PSG'
});

console.log(`PSG Price: $${result.currentPrice}`);
console.log(`24h Change: ${result.priceChangePercentage24h}%`);

Send Fan Tokens

// Send 100 PSG tokens
const tx = await client.callTool('send_tokens', {
  to: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1',
  amount: '100',
  token: 'PSG'
});

console.log(`Transaction sent: ${tx.hash}`);

Analyze Social Sentiment

// Get social sentiment for PSG token
const sentiment = await client.callTool('get_social_sentiment', {
  token: 'PSG',
  platforms: ['twitter', 'reddit']
});

console.log(`Overall Sentiment: ${sentiment.overall.sentiment}`);
console.log(`Total Mentions: ${sentiment.overall.totalMentions}`);
console.log(`Trending: ${sentiment.trending ? 'πŸ”₯ YES' : 'No'}`);

Configuration Options

Environment Variables

Variable Description Default Required
NETWORK Network to use (mainnet/testnet) mainnet No
CHILIZ_RPC_URL Chiliz Chain RPC endpoint https://spicy-rpc.chiliz.com/ No
COINGECKO_API_KEY CoinGecko API key for higher limits - No
PRIVATE_KEY Wallet private key for transactions - For TX

Cache Configuration

Cache Type TTL (seconds) Description
Price Data 60 Token prices and market data
Token List 3600 List of supported tokens
Blockchain Info 10 Network stats and block data
Transactions 300 Transaction details

Complete Tool Set

23+ specialized tools for every need

Price Tools

  • get_fan_token_price
  • get_multiple_prices
  • get_market_chart
  • get_trending_tokens

Wallet Tools

  • get_wallet_balance
  • get_my_balance

Blockchain Tools

  • get_blockchain_info
  • get_transaction

Token Tools

  • get_fan_tokens_list
  • get_token_holders
  • get_token_info

Transaction Tools

  • send_tokens
  • approve_token
  • swap_tokens

Analytics Tools

  • detect_whale_trades
  • calculate_token_velocity
  • identify_unusual_patterns
  • analyze_liquidity_depth
  • get_market_sentiment

Social Tools

  • get_social_sentiment
  • track_social_momentum
  • get_influencer_activity

Sports Tools

  • analyze_team_performance
  • get_upcoming_matches
  • get_league_standings

Supported Fan Tokens

Full support for 45+ official fan tokens worldwide

πŸ‡§πŸ‡· Brazilian Football Clubs

SPFC SΓ£o Paulo FC
GALO AtlΓ©tico Mineiro
VASCO Vasco da Gama
VERDAO Palmeiras
FLU Fluminense
BOT Botafogo
CRU Cruzeiro
INTER-BR Internacional
GREMIO GrΓͺmio

⚽ European Football Clubs

PSG Paris Saint-Germain
JUV Juventus
BAR FC Barcelona
CITY Manchester City
GAL Galatasaray
ACM AC Milan
INTER Inter Milan
ATM Atletico Madrid

πŸ† Sports & Esports

UFC UFC
PFL PFL
OG OG Esports
NAVI Natus Vincere

Ready to Get Started?

Join the growing community of developers using Chiliz MCP