MCP
Tools
Every Coffer MCP tool and what it returns
Coffer MCP has 15 tools. Eleven read public data. Four prepare an action for you to sign in the Coffer app. Your client receives each tool's parameters when it connects.
Pools
| Tool | What it returns |
|---|---|
coffer_get_overview | Total TVL, 24-hour and all-time volume, pool count, and the pool with the best APY right now |
coffer_list_pools | Pools filtered by up to three assets they must hold and by minimum TVL, sorted by TVL, APY, volume or age |
coffer_get_pool | One pool in full: each asset's weight, concentration factor, balance and value, plus fees, APY and the LP token |
coffer_get_pool_history | A pool's APY, TVL, volume or fees over 1 month, 6 months, 1 year or all time |
coffer_get_pool_transactions | A pool's latest swaps, deposits and withdrawals, optionally for one wallet |
coffer_get_metrics | Volume, swaps, fees, deposits, withdrawals or TVL over a day to all time, for Coffer or one pool |
Tokens and Swaps
| Tool | What it returns |
|---|---|
coffer_search_tokens | Tokens traded on Coffer, with mint, price and the deepest pools holding them |
coffer_quote_swap | Expected output, minimum received, fees, price impact, the route across pools and the XP the swap earns |
Wallets
| Tool | What it returns |
|---|---|
coffer_get_wallet_positions | A wallet's positions: share of each pool, current value and underlying tokens, plus its XP |
coffer_get_xp_leaderboard | The current XP epoch and rates, the leaderboard, and one wallet's rank |
coffer_get_transaction_status | Whether a transaction succeeded and how the wallet's balances changed |
Actions
Each action tool returns an estimate, the results of its checks and, if nothing blocks the action, a link to the Coffer app with the form filled in.
| Tool | You specify | Opens |
|---|---|---|
coffer_prepare_swap | Tokens, amount, slippage (2% by default, up to 5%) | Swap form |
coffer_prepare_add_liquidity | Pool, one of its assets and an amount; the other assets are added in the pool's ratio | Deposit form |
coffer_prepare_remove_liquidity | Pool, wallet and the percentage of the position to withdraw | Withdrawal form |
coffer_prepare_create_pool | Up to 10 assets with weight, concentration factor and opening amount, a name, a description and a swap fee | Create index form |
A new index can hold any SPL or Token-2022 token, not only ones already traded on Coffer. The opening amounts set the prices the index starts at, so the tool compares each asset's launch price with its market price and returns the amount that would match the market.
Conventions
- Pools are indexes. The app and agents call a pool an index. Tool
names and fields use
pool. - Amounts are plain decimals:
"1.5"means 1.5 SOL. - Percentages: fields ending in
Pctare percents, so1.5means 1.5%. Slippage is in basis points:200is 2%. - Tokens can be given by symbol (
SOL,USDC) or by mint address. Use the mint when a symbol is ambiguous. - APY:
apy7dPctcovers the last 7 days andapy24hPctthe last 24 hours. See What the displayed APY means.apyReliable: falsemarks a pool too small for its APY to mean much. - Links: every pool result includes a link to its page in the app.