MCP tools
Every tool the avee MCP server advertises, with its parameters. Generated from the server's own tool list.
The server at https://mcp.preview.avee.tech/mcp advertises 34 tools. All are read-only. An agent picks among them
from the descriptions below, which are the ones the server sends.
| Tool | What it does |
|---|---|
find_asset | Resolves a token or pair to its chain and contract address. |
get_candles | OHLCV candles for a pair at a chosen resolution (1..12H, 1D, 1W, 1M), quoted in the pair's quote token or in USD. |
get_chains | Every chain this instance indexes, one row each: TVL, 24h volume, transactions, buyers, pairs total and new, scam and flagged counts, deployer counts, the day's gainer, loser and volume leader, and the DEX names selectable in dex_names. |
get_deployer_launches | The pairs one deployer wallet launched, plus its reputation card: how many launches, how many went bad. |
get_deployer_list | Deployers ranked by reputation, launch count or spoiled launches, with score and launch-count filters. |
get_dex_list | Every indexed DEX deployment with its analytics: volume, liquidity and pair count per protocol. |
get_farm_list | Yield farms across chains: staking pools keyed by (chain, address, pid) with total value locked, the reward token and both the yearly and daily APR decomposition. |
get_latest_blocks | Last block each chain's indexer wrote. |
get_launchpad_tokens | Launchpad pools of one chain, newest first: stage new, bonding (curve open) or graduated (migrated). |
get_leaderboard | Ranking board: scope=chains ranks chains against each other, scope=protocols ranks the DEXes and launchpads inside one chain on one board. |
get_movers | Largest price gainers or losers over a window; dust pools are not ranked. |
get_new_pairs | Newest pairs of one chain. |
get_oracle_prices | avee oracle prices by feed id, latest or at a moment. |
get_order_book | Trades of one pair: buys, sells, mints, burns and liquidity events, with maker address and both legs priced. |
get_pair | Full state of one trading pair: both tokens, reserves, prices, liquidity USD, fee, ticker, APR, score, deployer, security and factory. |
get_pair_list | Rank or filter pairs across chains: by liquidity, score, volume, transactions, price change, holders, or the composite popular/hottest/trending sorts. |
get_perp_markets | Perp markets by 24h volume with mark, funding and open interest. |
get_token | Everything held on one token: symbol, name, decimals, supply, holders, status, trust score, USD price, its main pair, the market figures rolled up over every pair (24h volume and transactions, liquidity, market cap with an estimate flag, FDV, max and circulating supply, 1h/6h/24h change), the 0-100 rating with its components, the market-cap rank, category slugs, the launch record (deployer, transaction, block, time) and the tracked price range. |
get_token_brief | Everything needed to decide about a token in one call, under two kilobytes: the signed verdict, the trust score with the signals that made it, both liquidity figures with lock and burn percentages, the 24-hour market on the deepest pool, holder concentration, the deployer's launch and rug history, and the observed flags. |
get_token_holders | Top holders of a token by balance, with labels and tier. |
get_token_list | The token market list: one row per token per chain with the same market figures, categories and rating as get_token. |
get_token_traders | Who trades one token: the wallets holding or having closed a position in it, with their PNL on that token. |
get_token_verdict | What the avee trust oracle holds for one token, signed so it can be submitted on chain: status, the reasons in words, when the verdict was reached, when it was signed and when the signature expires. |
get_top_wallets | Leaderboard of traders: sort by rated or realized PNL, volume, win rate, trades or trader score, with filters for bots, scammers and copy eligibility. |
get_trending | Pairs trending now, with 5m-24h windows. |
get_wallet_best_trades | The wallet's best trades in the window, ranked by realized PNL. |
get_wallet_funding | Who funded a wallet: sender of its first native inflow, and when. |
get_wallet_labels | Labels for many wallets in one call: bot, sniper, wash trader, scammer and copy-eligibility flags. |
get_wallet_overview | One wallet across chains: PNL, volume and trade counts per chain over the trailing window. |
get_wallet_pnl_series | Daily realized PNL series for a wallet over the trailing window: the shape of the equity curve, not a single number. |
get_wallet_position_rounds | Completed round trips of a wallet: entry, exit, hold time and realized PNL per round, optionally for one token. |
get_wallet_positions | Positions of a wallet, open or closed: token, size, cost basis, unrealized and realized PNL. |
get_wallet_stats | Trader population of each chain: wallets total and new, humans versus bots, scammers, 24h PNL, volume and the day's favourite token. |
get_wallet_trades | Trade history of a wallet, newest first, with the token, both amounts and the USD value of each fill. |
find_asset
Resolves a token or pair to its chain and contract address. Takes a name, symbol, ticker or address and returns the matching tokens and pairs, each with chain, address, symbol and liquidity. Call this FIRST whenever the user names an asset ("WETH on robinhood") rather than giving an address, and whenever an address arrives without a chain — every other tool needs both.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | yes | token name, symbol, ticker or contract address |
chain_ids | integer[] | limit the search to these chain IDs | |
chains | enum[] | limit the search to these chain names | |
limit | integer | max results; defaults to 20 |
get_candles
OHLCV candles for a pair at a chosen resolution (1..12H, 1D, 1W, 1M), quoted in the pair's quote token or in USD.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the pair contract address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given | |
countback | integer | return exactly this many candles ending at to | |
from | integer | window start, unix seconds | |
price_from_quote | boolean | derive the price from the quote token side | |
price_in_usd | boolean | quote the candles in USD instead of the pair's quote token | |
resolution | enum | candle size; defaults to 1H | |
to | integer | window end, unix seconds | |
volume_from_quote | boolean | derive the volume from the quote token side |
get_chains
Every chain this instance indexes, one row each: TVL, 24h volume, transactions, buyers, pairs total and new, scam and flagged counts, deployer counts, the day's gainer, loser and volume leader, and the DEX names selectable in dex_names. Use it to learn which of the chains the schema lists are actually served here, and what each one holds.
| Parameter | Type | Required | Description |
|---|---|---|---|
chain_ids | integer[] | chain IDs; empty means every supported chain | |
chains | enum[] | chain names; empty means every chain |
get_deployer_launches
The pairs one deployer wallet launched, plus its reputation card: how many launches, how many went bad.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the deployer wallet address |
chain_ids | integer[] | filter by chain IDs | |
chains | enum[] | filter by chain names | |
cursor | string | pagination cursor over the deployer's pairs | |
limit | integer | max pairs; defaults to 50 | |
only_trustable | boolean | drop pairs flagged scam or blocked | |
order_by | enum | sort direction; defaults to desc One of asc, desc. | |
sort_by | enum | how to rank the deployer's pairs; defaults to the upstream order One of apr, created_at, holders, hottest, liquidity, popular, price_change, score, transactions, trending, updated_at, volume. |
get_deployer_list
Deployers ranked by reputation, launch count or spoiled launches, with score and launch-count filters.
| Parameter | Type | Required | Description |
|---|---|---|---|
chain_ids | integer[] | filter by chain IDs | |
chains | enum[] | filter by chain names | |
cursor | string | pagination cursor from a previous call | |
limit | integer | max results; defaults to 50 | |
max_score | integer | highest deployer score to include | |
min_launches | integer | only deployers with at least this many launches | |
min_score | integer | lowest deployer score to include | |
order_by | enum | sort direction; defaults to desc One of asc, desc. | |
sort_by | enum | how to rank the deployers; defaults to reputation One of first_launch, launches, reputation, spoiled_launches. | |
terminal_only | boolean | only deployers whose verdict is final |
get_dex_list
Every indexed DEX deployment with its analytics: volume, liquidity and pair count per protocol.
No parameters.
get_farm_list
Yield farms across chains: staking pools keyed by (chain, address, pid) with total value locked, the reward token and both the yearly and daily APR decomposition. Every row carries the contract's verification status, so an unverified pool is never read as a confirmed yield.
| Parameter | Type | Required | Description |
|---|---|---|---|
chain_ids | integer[] | chain IDs; at most 8 per call | |
chains | enum[] | chain names; at most 8 per call | |
cursor | string | pagination cursor from a previous call | |
factory_address | string[] | only farms deployed by these factories | |
limit | integer | max results; defaults to 50 | |
order_by | enum | sort direction; defaults to desc One of asc, desc. | |
search | string | filter by farm ticker | |
sort_by | enum | how to rank the farms; defaults to the upstream order One of apr, liquidity, tvl, updated_at. |
get_latest_blocks
Last block each chain's indexer wrote. Use it to judge how fresh the data behind an answer is.
No parameters.
get_launchpad_tokens
Launchpad pools of one chain, newest first: stage new, bonding (curve open) or graduated (migrated).
| Parameter | Type | Required | Description |
|---|---|---|---|
chain | enum | yes | chain name |
cursor | string | next_cursor from the last page | |
launch_status | enum | defaults to new One of bonding, graduated, new. | |
launchpads | string[] | only these launchpads | |
limit | integer | max rows |
get_leaderboard
Ranking board: scope=chains ranks chains against each other, scope=protocols ranks the DEXes and launchpads inside one chain on one board. Every pair counts once: a launchpad on Uniswap pools is its own row, labelled by category, with the protocols it trades on in infra. Seasonal rankings available.
| Parameter | Type | Required | Description |
|---|---|---|---|
chain | enum | the chain whose protocols to rank; required when scope is protocols | |
chain_id | integer | same as chain, by number | |
chains | enum[] | chain names to include when scope is chains | |
limit | integer | max rows | |
scope | enum | chains ranks chains against each other, protocols ranks the DEXes and launchpads inside one chain on one board, each row labelled by category; defaults to chains One of chains, protocols. | |
season | integer | season number; only with seasonal | |
seasonal | boolean | rank the season instead of all time |
get_movers
Largest price gainers or losers over a window; dust pools are not ranked.
| Parameter | Type | Required | Description |
|---|---|---|---|
chains | enum[] | chain names; empty is every chain | |
cursor | string | next_cursor from the last page | |
direction | enum | defaults to gainers One of gainers, losers. | |
limit | integer | max rows | |
time_frame | enum | defaults to 24h One of 1h, 24h, 5m, 6h. |
get_new_pairs
Newest pairs of one chain.
| Parameter | Type | Required | Description |
|---|---|---|---|
chain | enum | yes | chain name |
cursor | string | next_cursor from the last page | |
limit | integer | max rows | |
max_age_seconds | integer | oldest pair age | |
min_liquidity_usd | number | lowest liquidity |
get_oracle_prices
avee oracle prices by feed id, latest or at a moment.
| Parameter | Type | Required | Description |
|---|---|---|---|
ids | string[] | yes | 64-hex feed ids |
publish_time | integer | unix seconds; omit for latest |
get_order_book
Trades of one pair: buys, sells, mints, burns and liquidity events, with maker address and both legs priced.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the pair contract address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given | |
cursor | string | pagination cursor from a previous call | |
limit | integer | max results; defaults to 100 | |
maker_address | string | only trades of this wallet | |
max_timestamp | integer | window end, unix seconds | |
min_timestamp | integer | window start, unix seconds | |
order_by | enum | sort direction; defaults to desc One of asc, desc. | |
types | enum[] | which transaction kinds to include; defaults to Buy and Sell One of AddLiquidity, Burn, Buy, Mint, RemoveLiquidity, Sell. |
get_pair
Full state of one trading pair: both tokens, reserves, prices, liquidity USD, fee, ticker, APR, score, deployer, security and factory. agg_statistics adds the 5m/1h/6h/24h windows, each with price change, buy and sell volume and buy and sell counts.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the pair contract address |
agg_statistics | boolean | include the 5m 1h 6h 24h aggregates | |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given |
get_pair_list
Rank or filter pairs across chains: by liquidity, score, volume, transactions, price change, holders, or the composite popular/hottest/trending sorts. Supports search, DEX filters and a liquidity range.
| Parameter | Type | Required | Description |
|---|---|---|---|
agg_statistics | boolean | include the 5m 1h 6h 24h aggregates | |
chain_ids | integer[] | filter by chain IDs | |
chains | enum[] | filter by chain names | |
cursor | string | pagination cursor from a previous call | |
dex_names | string[] | filter by DEX names | |
dex_protocols | string[] | filter by DEX protocols | |
limit | integer | max results; defaults to 50 | |
max_liquidity_usd | number | highest liquidity to include | |
min_liquidity_usd | number | lowest liquidity to include | |
only_trustable | boolean | drop pairs flagged scam or blocked | |
order_by | enum | sort direction; defaults to desc One of asc, desc. | |
search | string | filter by ticker, token symbol or DEX name | |
sort_by | enum | how to rank the pairs; defaults to the upstream order One of apr, created_at, holders, hottest, liquidity, popular, price_change, score, transactions, trending, updated_at, volume. | |
time_frame | enum | window the metric sort reads One of 1h, 24h, 5m, 6h. |
get_perp_markets
Perp markets by 24h volume with mark, funding and open interest.
| Parameter | Type | Required | Description |
|---|---|---|---|
cursor | string | next_cursor from the last page | |
limit | integer | max rows | |
search | string | ticker substring |
get_token
Everything held on one token: symbol, name, decimals, supply, holders, status, trust score, USD price, its main pair, the market figures rolled up over every pair (24h volume and transactions, liquidity, market cap with an estimate flag, FDV, max and circulating supply, 1h/6h/24h change), the 0-100 rating with its components, the market-cap rank, category slugs, the launch record (deployer, transaction, block, time) and the tracked price range. A blocked token is not found.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the token contract address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given | |
resolutions | enum[] | price change windows to include |
get_token_brief
Everything needed to decide about a token in one call, under two kilobytes: the signed verdict, the trust score with the signals that made it, both liquidity figures with lock and burn percentages, the 24-hour market on the deepest pool, holder concentration, the deployer's launch and rug history, and the observed flags. Prefer this over calling get_token, get_pair and get_token_verdict separately.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | contract address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given |
get_token_holders
Top holders of a token by balance, with labels and tier.
| Parameter | Type | Required | Description |
|---|---|---|---|
chain | enum | yes | chain name |
token | string | yes | token address |
cursor | string | next_cursor from the last page | |
limit | integer | max rows |
get_token_list
The token market list: one row per token per chain with the same market figures, categories and rating as get_token. Sorted by market cap by default, or by volume, liquidity, price change, launch time, holders, rating, FDV or transactions. Filters: chains, categories, search by name, ticker or address, and liquidity, volume, market cap, FDV, age, score and holder ranges.
| Parameter | Type | Required | Description |
|---|---|---|---|
categories | string[] | category slugs such as stablecoin, wrapped, meme or ai-agents; a token matches any of them | |
chain_ids | integer[] | filter by chain IDs | |
chains | enum[] | filter by chain names | |
cursor | string | pagination cursor from a previous call | |
limit | integer | max results; defaults to 50 | |
max_age_seconds | integer | only tokens launched at most this long ago | |
max_fdv_usd | number | highest fully diluted valuation | |
max_holders | integer | most tracked holders | |
max_liquidity_usd | number | highest liquidity across the token's pairs | |
max_market_cap_usd | number | highest market cap | |
max_score | integer | highest token trust score, 0-100 | |
max_volume_usd | number | highest 24h volume | |
min_age_seconds | integer | only tokens launched at least this long ago | |
min_fdv_usd | number | lowest fully diluted valuation | |
min_holders | integer | fewest tracked holders | |
min_liquidity_usd | number | lowest liquidity across the token's pairs | |
min_market_cap_usd | number | lowest market cap | |
min_score | integer | lowest token trust score, 0-100 | |
min_volume_usd | number | lowest 24h volume | |
order_by | enum | sort direction; defaults to desc One of asc, desc. | |
resolutions | enum[] | price change windows to include | |
search | string | token name, ticker or address | |
sort_by | enum | how to rank the tokens; defaults to market_cap One of created_at, fdv, holders, liquidity, market_cap, price_change, rating, txns, volume. | |
sort_value | string | resolution the sort field is read at, e.g. 24H |
get_token_traders
Who trades one token: the wallets holding or having closed a position in it, with their PNL on that token.
| Parameter | Type | Required | Description |
|---|---|---|---|
token | string | yes | the token contract address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given | |
cursor | string | pagination cursor from a previous call | |
limit | integer | max traders; defaults to 50 | |
state | enum | which positions to include; defaults to any One of any, closed, open. |
get_token_verdict
What the avee trust oracle holds for one token, signed so it can be submitted on chain: status, the reasons in words, when the verdict was reached, when it was signed and when the signature expires. status=ok means no block is recorded — it is never a clearance; status=unknown means nobody has evaluated the token and must not be read as 'not blocked'.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | contract address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given |
get_top_wallets
Leaderboard of traders: sort by rated or realized PNL, volume, win rate, trades or trader score, with filters for bots, scammers and copy eligibility.
| Parameter | Type | Required | Description |
|---|---|---|---|
ascending | boolean | sort ascending instead of descending | |
chain_ids | integer[] | filter by chain IDs | |
chains | enum[] | filter by chain names | |
cursor | string | pagination cursor from a previous call | |
exclude_bots | boolean | drop wallets labelled as bots | |
limit | integer | max wallets; defaults to 50 | |
max_scammer_score | integer | drop wallets above this scammer score | |
min_realized_pnl_usd | number | only wallets above this realized PNL | |
min_total_pnl_usd | number | only wallets above this total PNL | |
min_trades | integer | only wallets with at least this many trades | |
min_user_score | integer | only wallets at or above this wallet score | |
min_volume_usd | number | only wallets above this traded volume | |
min_win_rate | number | only wallets above this win rate | |
no_abuse_evidence | boolean | only wallets with no abuse evidence at all | |
only_copy_eligible | boolean | only wallets that pass the copy-trading gate | |
sort_by | enum | how to rank the wallets; defaults to rated_pnl One of rated_pnl, realized_pnl, scammer_score, trades, user_score, volume, win_rate. | |
window_days | enum | trailing window in days One of 1, 7, 30. |
get_trending
Pairs trending now, with 5m-24h windows.
| Parameter | Type | Required | Description |
|---|---|---|---|
chains | enum[] | chain names; empty is every chain | |
cursor | string | next_cursor from the last page | |
limit | integer | max rows |
get_wallet_best_trades
The wallet's best trades in the window, ranked by realized PNL. Use it to explain how a trader made their money.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the wallet address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given | |
limit | integer | max trades; defaults to 10 | |
window_days | enum | trailing window in days One of 1, 7, 30. |
get_wallet_funding
Who funded a wallet: sender of its first native inflow, and when.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | wallet address |
chain | enum | yes | chain name |
get_wallet_labels
Labels for many wallets in one call: bot, sniper, wash trader, scammer and copy-eligibility flags.
| Parameter | Type | Required | Description |
|---|---|---|---|
addresses | string[] | yes | wallet addresses to label |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given |
get_wallet_overview
One wallet across chains: PNL, volume and trade counts per chain over the trailing window.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the wallet address |
chain_ids | integer[] | chain IDs; empty means every chain | |
chains | enum[] | chain names; empty means every chain | |
window_days | enum | trailing window in days One of 1, 7, 30. |
get_wallet_pnl_series
Daily realized PNL series for a wallet over the trailing window: the shape of the equity curve, not a single number.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the wallet address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given | |
window_days | enum | trailing window in days One of 1, 7, 30. |
get_wallet_position_rounds
Completed round trips of a wallet: entry, exit, hold time and realized PNL per round, optionally for one token.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the wallet address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given | |
cursor | string | pagination cursor from a previous call | |
limit | integer | max rounds; defaults to 50 | |
state | enum | which positions to include; defaults to any One of any, closed, open. | |
token | string | only rounds on this token address |
get_wallet_positions
Positions of a wallet, open or closed: token, size, cost basis, unrealized and realized PNL.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the wallet address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given | |
cursor | string | pagination cursor from a previous call | |
limit | integer | max positions; defaults to 50 | |
state | enum | which positions to include; defaults to any One of any, closed, open. |
get_wallet_stats
Trader population of each chain: wallets total and new, humans versus bots, scammers, 24h PNL, volume and the day's favourite token.
| Parameter | Type | Required | Description |
|---|---|---|---|
chain_ids | integer[] | chain IDs; empty means every supported chain | |
chains | enum[] | chain names; empty means every chain |
get_wallet_trades
Trade history of a wallet, newest first, with the token, both amounts and the USD value of each fill.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | yes | the wallet address |
chain | enum | chain name; required unless chain_id is given | |
chain_id | integer | chain id; an alternative to chain, and wins when both are given | |
cursor | string | pagination cursor from a previous call | |
limit | integer | max trades; defaults to 50 |