Coffer Docs
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

ToolWhat it returns
coffer_get_overviewTotal TVL, 24-hour and all-time volume, pool count, and the pool with the best APY right now
coffer_list_poolsPools filtered by up to three assets they must hold and by minimum TVL, sorted by TVL, APY, volume or age
coffer_get_poolOne pool in full: each asset's weight, concentration factor, balance and value, plus fees, APY and the LP token
coffer_get_pool_historyA pool's APY, TVL, volume or fees over 1 month, 6 months, 1 year or all time
coffer_get_pool_transactionsA pool's latest swaps, deposits and withdrawals, optionally for one wallet
coffer_get_metricsVolume, swaps, fees, deposits, withdrawals or TVL over a day to all time, for Coffer or one pool

Tokens and Swaps

ToolWhat it returns
coffer_search_tokensTokens traded on Coffer, with mint, price and the deepest pools holding them
coffer_quote_swapExpected output, minimum received, fees, price impact, the route across pools and the XP the swap earns

Wallets

ToolWhat it returns
coffer_get_wallet_positionsA wallet's positions: share of each pool, current value and underlying tokens, plus its XP
coffer_get_xp_leaderboardThe current XP epoch and rates, the leaderboard, and one wallet's rank
coffer_get_transaction_statusWhether 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.

ToolYou specifyOpens
coffer_prepare_swapTokens, amount, slippage (2% by default, up to 5%)Swap form
coffer_prepare_add_liquidityPool, one of its assets and an amount; the other assets are added in the pool's ratioDeposit form
coffer_prepare_remove_liquidityPool, wallet and the percentage of the position to withdrawWithdrawal form
coffer_prepare_create_poolUp to 10 assets with weight, concentration factor and opening amount, a name, a description and a swap feeCreate 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 Pct are percents, so 1.5 means 1.5%. Slippage is in basis points: 200 is 2%.
  • Tokens can be given by symbol (SOL, USDC) or by mint address. Use the mint when a symbol is ambiguous.
  • APY: apy7dPct covers the last 7 days and apy24hPct the last 24 hours. See What the displayed APY means. apyReliable: false marks a pool too small for its APY to mean much.
  • Links: every pool result includes a link to its page in the app.

On this page