Fan Token Intel

Official22 tools

by BrunoPessoa22

Fan-token intelligence for Chiliz Chain: prices, whale flows, match event impact. 22 read tools.

Captured live from the server via tools/list.

tokenintel_discover

Discover available tools on the Fan Token Intel MCP server. Returns tool names and one-line descriptions, organized by category. Call with no arguments for all categories, or specify a category to filter. Categories: market_data, signals, sports, social, defi, agent, portfolio, volume, chain_info. Tip: connect with ?modules=market_data,signals to load only specific categories.

Parameters1

tokenintel_describe

Get the full input schema for a specific tool. Returns the JSON Schema (parameters, types, required fields, descriptions) needed to call the tool via tokenintel_invoke. Use tokenintel_discover first to find tool names.

Parameters1

tool_name

string

required

The tool name to describe (e.g. 'tokenintel_whale_flows').

Raw schema

{
  "type": "object",
  "properties": {
    "tool_name": {
      "type": "string",
      "description": "The tool name to describe (e.g. 'tokenintel_whale_flows')."
    }
  },
  "required": [
    "tool_name"
  ]
}

tokenintel_invoke

Invoke any tool on the Fan Token Intel MCP server by name. Pass the tool_name and its arguments. The result is identical to calling the tool directly. Auth and rate limits apply as normal. Use tokenintel_describe to get the required arguments first.

Parameters2

tool_name	string	required	The tool to invoke (e.g. 'tokenintel_whale_flows').
arguments	object	optional	Arguments to pass to the tool (matches the tool's inputSchema).

Raw schema

{
  "type": "object",
  "properties": {
    "tool_name": {
      "type": "string",
      "description": "The tool to invoke (e.g. 'tokenintel_whale_flows')."
    },
    "arguments": {
      "type": "object",
      "description": "Arguments to pass to the tool (matches the tool's inputSchema).",
      "default": {}
    }
  },
  "required": [
    "tool_name"
  ]
}

tokenintel_briefing

All-in-one ECOSYSTEM briefing: market regime, active signals, anomalies, health matrix, sports calendar, and whale activity in one response. Use instead of calling 6+ tools sequentially. USE THIS for a market-wide overview. USE tokenintel_token_context for a SINGLE-TOKEN deep dive (price, signals, health, whale flow, sports catalyst, news — all for one symbol). Returns data, not recommendations -- interpret results yourself.

Parameters2

focus	string	optional	Optional token symbol to focus on (e.g., 'BAR'). Omit for full ecosystem view.
timeframe	string	optional	Briefing depth: 'morning' (24h window, default) or 'weekly' (7-day trends).

Raw schema

{
  "type": "object",
  "properties": {
    "focus": {
      "type": "string",
      "description": "Optional token symbol to focus on (e.g., 'BAR'). Omit for full ecosystem view."
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "morning",
        "weekly"
      ],
      "description": "Briefing depth: 'morning' (24h window, default) or 'weekly' (7-day trends)."
    }
  },
  "required": []
}

tokenintel_health_matrix

Get health grades (A-F) for all tracked fan tokens. Each token is scored across price momentum, volume, social activity, and whale pressure. Use this to quickly filter which tokens deserve attention. Grade A/B = strong, D/F = weak or distressed. Pass response_format='concise' to get just symbol/grade/score/change (~70% smaller) when you don't need team/league/volume/age detail.

Parameters1

response_format

string

optional

'detailed' (default) = all fields + legend; 'concise' = symbol/grade/score/change_24h only.

Raw schema

{
  "type": "object",
  "properties": {
    "response_format": {
      "type": "string",
      "enum": [
        "detailed",
        "concise"
      ],
      "description": "'detailed' (default) = all fields + legend; 'concise' = symbol/grade/score/change_24h only."
    }
  },
  "required": []
}

tokenintel_market_regime

Get current market conditions — BTC trend, CHZ momentum, fear/greed index, and the platform's market regime classification. Useful for filtering or adjusting signal confidence based on macro conditions.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

tokenintel_macro_context

Get current crypto macro context: BTC dominance, CHZ price, funding rates, fear & greed index, and risk environment assessment.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

tokenintel_token_context

SINGLE-TOKEN deep dive: realtime price, CEX whale flow, on-chain Chiliz Chain (FanX) liquidity with slippage at 1%/5% of reserves, and upcoming matches for one symbol. The default tool to call before evaluating a trading decision on a specific token. USE THIS when you have a target token in mind. USE tokenintel_briefing when you want the market-wide overview instead.

Parameters1

token

string

required

Token symbol (e.g., ASR, BAR, CHZ)

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token symbol (e.g., ASR, BAR, CHZ)"
    }
  },
  "required": [
    "token"
  ]
}

tokenintel_realtime_prices

Get the freshest available prices with staleness metadata. Returns price_age_seconds so agents know exactly how stale each price is. Lightweight and fast -- call this before any trade decision to get current prices. Supports multiple tokens in a single call.

Parameters1

tokens

string

required

Comma-separated token symbols (e.g., 'BAR,PSG,JUV')

Raw schema

{
  "type": "object",
  "properties": {
    "tokens": {
      "type": "string",
      "description": "Comma-separated token symbols (e.g., 'BAR,PSG,JUV')"
    }
  },
  "required": [
    "tokens"
  ]
}

tokenintel_price_candles

Historical OHLCV price candles for any fan token. Intervals: 1h, 4h, 1d. Up to 180 days lookback. Returns open, high, low, close, volume for each period. Use for backtesting, charting, trend analysis, or building your own signals.

Parameters4

token	string	required	Token symbol (e.g., 'BAR', 'PSG', 'CHZ').
interval	string	optional	Candle interval. Default: 4h.
days	integer	optional	Lookback in days (max 180). Default: 30.
limit	integer	optional	Max candles to return (max 500). Default: 200.

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token symbol (e.g., 'BAR', 'PSG', 'CHZ')."
    },
    "interval": {
      "type": "string",
      "enum": [
        "1h",
        "4h",
        "1d"
      ],
      "description": "Candle interval. Default: 4h."
    },
    "days": {
      "type": "integer",
      "description": "Lookback in days (max 180). Default: 30."
    },
    "limit": {
      "type": "integer",
      "description": "Max candles to return (max 500). Default: 200."
    }
  },
  "required": [
    "token"
  ]
}

tokenintel_whale_flows

Get real-time whale distribution data for a fan token. Shows the ratio of whale sells to total whale activity on CEX exchanges. A sell_ratio above 0.65 indicates distribution (bearish). Data aggregated from CEX exchanges in real-time. USE THIS for aggregate buy/sell pressure on CEX. USE tokenintel_whale_trades for individual trade rows. USE tokenintel_dex_whales for on-chain (Chiliz Chain) swap whales.

Parameters3

token	string	required	Token symbol (e.g., ASR, BAR, CHZ, CITY, ATM, ACM, JUV, PSG)
timeframe_hours	integer	optional	Lookback window in hours (default: 4)
exchange	string	optional	Filter by specific exchange (optional). Options: binance, okx, htx, kucoin, bybit, gate, mexc, mercadobitcoin, upbit, coinbase

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token symbol (e.g., ASR, BAR, CHZ, CITY, ATM, ACM, JUV, PSG)"
    },
    "timeframe_hours": {
      "type": "integer",
      "description": "Lookback window in hours (default: 4)",
      "default": 4
    },
    "exchange": {
      "type": "string",
      "description": "Filter by specific exchange (optional). Options: binance, okx, htx, kucoin, bybit, gate, mexc, mercadobitcoin, upbit, coinbase"
    }
  },
  "required": [
    "token"
  ]
}

tokenintel_social_sentiment

Social sentiment for a fan token, driven by the live LunarCrush aggregated feed (galaxy score, alt rank, social volume, sentiment). Also surfaces native Twitter/X, Reddit, YouTube and news blocks WHEN those ingestion feeds are active — check the data_sources field in the response to see which sources carried data (some native feeds may be inactive). overall_sentiment is computed only from sources reporting activity. Descriptive community-mood data, not a recommendation.

Parameters2

token	string	required	Token symbol (e.g., ASR, BAR, PSG). Required.
hours	integer	optional	Lookback window in hours (default: 24, max: 168)

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token symbol (e.g., ASR, BAR, PSG). Required."
    },
    "hours": {
      "type": "integer",
      "description": "Lookback window in hours (default: 24, max: 168)",
      "default": 24
    }
  },
  "required": [
    "token"
  ]
}

tokenintel_capital_rotation

Cross-token capital flow analysis. Shows which fan tokens are gaining vs losing volume relative to their recent average. Detects rotation: when whales exit one token, where does the capital go?

Parameters1

hours

integer

optional

Compare last N hours vs prior period. Default: 24.

Raw schema

{
  "type": "object",
  "properties": {
    "hours": {
      "type": "integer",
      "description": "Compare last N hours vs prior period. Default: 24."
    }
  },
  "required": []
}

tokenintel_match_impact_history

Historical match price impact data for a fan token. Returns price snapshots at kickoff, fulltime, +1h, +24h with returns for each match. Filter by result (win/loss/draw), competition, venue. Use for backtesting sports-driven strategies.

Parameters4

token	string	required	Token symbol (e.g., 'BAR').
result	string	optional	Filter by match result. Default: all.
days	integer	optional	Lookback in days (max 365). Default: 90.
limit	integer	optional	Max matches (max 200). Default: 100.

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token symbol (e.g., 'BAR')."
    },
    "result": {
      "type": "string",
      "enum": [
        "win",
        "loss",
        "draw",
        "all"
      ],
      "description": "Filter by match result. Default: all."
    },
    "days": {
      "type": "integer",
      "description": "Lookback in days (max 365). Default: 90."
    },
    "limit": {
      "type": "integer",
      "description": "Max matches (max 200). Default: 100."
    }
  },
  "required": [
    "token"
  ]
}

tokenintel_match_correlation

Historical match-to-price correlation. Ask 'what happens to BAR after Champions League wins?' and get backtested data with price impact percentages. Returns individual match records with price at kickoff, fulltime, +1h, +24h and aggregate stats (avg impact, win rate, best/worst).

Parameters5

token	string	required	Token symbol (e.g., BAR, PSG, JUV)
result_filter	string	optional	Filter by match result
competition_filter	string	optional	Filter by competition type: champions_league, europa_league, domestic, cup, or all
venue_filter	string	optional	Filter by home/away
limit	integer	optional	Number of matches to return (default 20, max 100)

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token symbol (e.g., BAR, PSG, JUV)"
    },
    "result_filter": {
      "type": "string",
      "enum": [
        "win",
        "loss",
        "draw",
        "all"
      ],
      "description": "Filter by match result",
      "default": "all"
    },
    "competition_filter": {
      "type": "string",
      "description": "Filter by competition type: champions_league, europa_league, domestic, cup, or all",
      "default": "all"
    },
    "venue_filter": {
      "type": "string",
      "enum": [
        "home",
        "away",
        "all"
      ],
      "description": "Filter by home/away",
      "default": "all"
    },
    "limit": {
      "type": "integer",
      "description": "Number of matches to return (default 20, max 100)",
      "default": 20
    }
  },
  "required": [
    "token"
  ]
}

tokenintel_goal_direction_asymmetry

THE event-impact moat: how a fan token reacts when its team SCORES vs CONCEDES a goal, market-adjusted vs CHZ at +15/+30/+60m. The blended 'all goals' number hides the real signal — scoring is ~priced-in, conceding moves price. Returns the scored-vs-conceded decomposition with sample sizes and directional hit rates. Only computable here (needs the token<->team map). Descriptive history, not advice.

Parameters1

minute_bucket

string

optional

Optional: restrict to goals in this match-minute bucket.

Raw schema

{
  "type": "object",
  "properties": {
    "minute_bucket": {
      "type": "string",
      "enum": [
        "0-15",
        "16-30",
        "31-45",
        "46-60",
        "61-75",
        "76-90",
        "90+"
      ],
      "description": "Optional: restrict to goals in this match-minute bucket."
    }
  },
  "required": []
}

tokenintel_event_reaction_profile

Event-conditioned, market-adjusted (vs CHZ) token reaction profiles for football events — by event_type x event_side(for/against) x minute x scoreline_state x importance. Returns mean/median abnormal return, match-clustered t-stat, bootstrap 95% CI, hit rate, decay/persistence, n_events, n_matches, FDR. Omit a dimension to pool. Every cell carries its sample size — descriptive history, not advice.

Parameters7

event_type	string	optional	Event type.
event_side	string	optional	'for' = token's team scored / opponent sent off; 'against' = conceded / own red card.
minute_bucket	string	optional
scoreline_state	string	optional	Token team's state BEFORE the event.
importance	string	optional	Match importance bucket (e.g. high/medium/low).
horizon_min	integer	optional	Reaction horizon. Default 30.
clean_only	boolean	optional	Only non-overlapping events (conservative). Default true.

Raw schema

{
  "type": "object",
  "properties": {
    "event_type": {
      "type": "string",
      "enum": [
        "goal",
        "red_card"
      ],
      "description": "Event type."
    },
    "event_side": {
      "type": "string",
      "enum": [
        "for",
        "against"
      ],
      "description": "'for' = token's team scored / opponent sent off; 'against' = conceded / own red card."
    },
    "minute_bucket": {
      "type": "string",
      "enum": [
        "0-15",
        "16-30",
        "31-45",
        "46-60",
        "61-75",
        "76-90",
        "90+"
      ]
    },
    "scoreline_state": {
      "type": "string",
      "enum": [
        "leading",
        "level",
        "trailing"
      ],
      "description": "Token team's state BEFORE the event."
    },
    "importance": {
      "type": "string",
      "description": "Match importance bucket (e.g. high/medium/low)."
    },
    "horizon_min": {
      "type": "integer",
      "enum": [
        15,
        30,
        60
      ],
      "description": "Reaction horizon. Default 30."
    },
    "clean_only": {
      "type": "boolean",
      "description": "Only non-overlapping events (conservative). Default true."
    }
  },
  "required": []
}

tokenintel_late_game_redcard_profile

Red-card reaction profile (market-adjusted vs CHZ). Rare and high-impact: returns abnormal return at +15/+30/+60m with honest wide confidence intervals and sample size; flags cells with n<15. Descriptive history, not advice.

Parameters2

event_side	string	optional	'against' = token team's player sent off; 'for' = opponent sent off.
minute_bucket	string	optional	Optional match-minute bucket (e.g. '76-90' for late reds).

Raw schema

{
  "type": "object",
  "properties": {
    "event_side": {
      "type": "string",
      "enum": [
        "for",
        "against"
      ],
      "description": "'against' = token team's player sent off; 'for' = opponent sent off."
    },
    "minute_bucket": {
      "type": "string",
      "enum": [
        "0-15",
        "16-30",
        "31-45",
        "46-60",
        "61-75",
        "76-90",
        "90+"
      ],
      "description": "Optional match-minute bucket (e.g. '76-90' for late reds)."
    }
  },
  "required": []
}

tokenintel_match_event_replay

Event-by-event reaction tape for a single match: each goal/red card with its minute, running score, scoreline state, and the market-adjusted token reaction at +15/+30/+60m (plus pre-event drift). The non-reconstructable moat artifact. match_id selects that fixture; token (+ optional date) resolves ONE fixture (the date-selected or most recent) and returns its tape, match metadata, and an other_matches index. Events are never merged across fixtures.

Parameters3

match_id	string	optional	The matches.match_id (e.g. 'apifb_1391197').
token	string	optional	Token symbol — resolves its most recent (or date-selected) measured fixture.
date	string	optional	Optional YYYY-MM-DD; with token, selects that day's fixture instead of the most recent.

Raw schema

{
  "type": "object",
  "properties": {
    "match_id": {
      "type": "string",
      "description": "The matches.match_id (e.g. 'apifb_1391197')."
    },
    "token": {
      "type": "string",
      "description": "Token symbol — resolves its most recent (or date-selected) measured fixture."
    },
    "date": {
      "type": "string",
      "description": "Optional YYYY-MM-DD; with token, selects that day's fixture instead of the most recent."
    }
  },
  "required": []
}

tokenintel_governance_validators

List active validators on Chiliz Chain governance. Shows validator addresses and total CHZ delegated to each. Use this to find the best validator before staking.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

tokenintel_dex_depth

Get DEX depth and slippage curves for fan token pools on Chiliz Chain. Computes constant-product (x*y=k) price impact at trade sizes [1%, 5%, 10%, 25%] of pool reserves. Useful for agents evaluating execution costs before trading. Data from latest on-chain liquidity snapshots.

Parameters1

token

string

optional

Token symbol (optional). If omitted, returns all CHZ pairs sorted by TVL.

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token symbol (optional). If omitted, returns all CHZ pairs sorted by TVL."
    }
  },
  "required": []
}

tokenintel_dex_liquidity

Get on-chain DEX liquidity data for fan tokens on Chiliz Chain. Returns pool TVL, depth, token reserves, and estimated slippage. Critical for agents that want to understand execution costs before trading on-chain.

Parameters1

token

string

optional

Token symbol (optional). If omitted, returns all pools sorted by TVL.

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token symbol (optional). If omitted, returns all pools sorted by TVL."
    }
  },
  "required": []
}

Install

Tools (22)

tokenintel_discovertokenintel_describetokenintel_invoketokenintel_briefingtokenintel_health_matrixtokenintel_market_regimetokenintel_macro_contexttokenintel_token_context

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp-production-f681.up.railway.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "fan-token-intel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-production-f681.up.railway.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.