​
MCP tools catalog

The agent registers 90 MCP tools across 14 domains. Every tool is exposed over Streamable HTTP MCP and as a mirrored REST endpoint at /api/v1/agent/* — pick whichever fits your caller. Both paths call the same service layer. Each domain section below renders as a collapsed accordion list. Click a tool to expand its description, argument table, and access tier. Use your browser’s find-in-page (ctrl-F / cmd-F) to locate a tool by name — collapsed accordions are still text-searchable.

​
How to read this catalog

  • Access is one of:
    • free — no auth, no charge (discovery, status, demo)
    • auth — requires X-API-Key (or Bearer JWT)
    • x402 — pay-per-call via x402 micropayment; check the tool’s price field
  • Args with required = yes must be supplied; the rest fall back to server defaults.
  • Type strings (string, integer, array<Strategy>, …) reflect the agent’s MCP schema, not Python types.
This page is generated from mangrove-agent/server/src/mcp/tools.py via scripts/generate-mcp-tools-catalog.py. When the agent adds or renames a tool, re-run the generator and commit the regenerated MDX.

​
Discovery

2 tool(s) in this domain.
MCP tool catalog (name, tier, params, pricing). Free, no auth.No arguments.Access: freeREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Agent status + counts + uptime. Free, no auth.No arguments.Access: freeREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
Wallet

9 tool(s) in this domain.
Create + encrypt a wallet. Response carries only vault_token + reveal_cmd — plaintext never enters the Claude Code transcript. EVM only in v1.Args
NameTypeRequiredDescription
chainstringnoevm (default). xrpl stubbed 501 in v1.
networkstringnomainnet (default) | testnet
chain_idintegernoDefault 8453 (Base mainnet)
labelstringnoHuman-friendly name
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Token balances for a wallet.Args
NameTypeRequiredDescription
addressstringyesWallet address
chain_idintegeryesEVM chain id
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Import an existing wallet from a stashed vault_token. The user must obtain the id by running scripts/stash-secret.sh in a terminal FIRST — this tool refuses raw keys by design.Args
NameTypeRequiredDescription
vault_tokenstringyesFrom scripts/stash-secret.sh output
chainstringnoevm (default)
networkstringnomainnet (default) | testnet
chain_idintegernoDefault 8453 (Base mainnet)
labelstringnoHuman-friendly name
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List stored wallets (secrets never returned).Args
NameTypeRequiredDescription
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
DeFi positions (LP, lending, staking) across wallets.Args
NameTypeRequiredDescription
addressesstringyesComma-separated wallet addresses
chain_idintegernoOptional: pin to a single chain
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
On-chain tx history for a single wallet (all txs, not just strategy-driven).Args
NameTypeRequiredDescription
addressstringyesSingle wallet address
limitintegernoMax results (default 50)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Realized + unrealized P&L for one or more wallets.Args
NameTypeRequiredDescription
addressesstringyesComma-separated wallet addresses
chain_idintegernoOptional: pin to a single chain
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Per-token holdings with USD value + per-position P&L.Args
NameTypeRequiredDescription
addressesstringyesComma-separated wallet addresses
chain_idintegernoOptional: pin to a single chain
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Aggregate USD value of one or more wallet addresses.Args
NameTypeRequiredDescription
addressesstringyesComma-separated wallet addresses
chain_idintegernoOptional: pin to a single chain
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
DEX

10 tool(s) in this domain.
Execute a DEX swap (requires confirm=true + explicit slippage_pct). Single code path shared with cron-driven trades. Slippage is always user-specified — no default — because picking a tolerance is a risk decision.Args
NameTypeRequiredDescription
input_tokenstringyesInput token
output_tokenstringyesOutput token
amountnumberyesInput amount
chain_idintegeryesEVM chain id
wallet_addressstringyesWallet from local store
slippage_pctnumberyesSlippage tolerance as DECIMAL, capped at 0.0025 (0.25%). Typical: 0.001 (0.1%), 0.002 (0.2%), 0.0025 (max). Higher values refused.
venue_idstringnoOptional specific venue
confirmbooleanyesMust be true
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Check ERC-20 allowances a wallet has granted a spender (approve_token output).Args
NameTypeRequiredDescription
chain_idintegeryesEVM chain id
walletstringyesWallet address
spenderstringyesSpender contract address (e.g. a router)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
⚠️ BROKEN upstream (SDK sends token0/token1, server wants address). Use get_ohlcv for price history until fixed.Args
NameTypeRequiredDescription
chain_idintegeryesEVM chain id
token0stringyesBase token (symbol or address)
token1stringyesQuote token (symbol or address)
periodstringnoBar period (default ‘1h’)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Gas price estimate for a chain (pre-flight before execute_swap).Args
NameTypeRequiredDescription
chain_idintegeryesEVM chain id
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Current spot price for one or more tokens on a chain.Args
NameTypeRequiredDescription
chain_idintegeryesEVM chain id
tokensstringyesComma-separated token symbols or addresses
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Get a DEX swap quote. Optionally pin a venue + mode.Args
NameTypeRequiredDescription
input_tokenstringyesInput token
output_tokenstringyesOutput token
amountnumberyesInput amount
chain_idintegeryesEVM chain id
venue_idstringnoOptional specific venue
modestringnoOptional routing hint (venue-specific)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
⚠️ BROKEN upstream (MangroveMarkets-MCP-Server#62). Use kb_glossary_get / kb_search for token concepts until SDK bump.Args
NameTypeRequiredDescription
chain_idintegeryesEVM chain id
addressstringyesToken contract address
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Verify a broadcast transaction’s final state. Call after execute_swap — the returned tx_hash isn’t confirmed yet. Returns status: confirmed | pending | failed + block info.Args
NameTypeRequiredDescription
tx_hashstringyesTransaction hash returned by execute_swap
chain_idintegeryesEVM chain id (8453 = Base mainnet)
venue_idstringnoOptional: pin to a specific venue
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List supported DEX venues.Args
NameTypeRequiredDescription
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
Market data

6 tool(s) in this domain.
Single-asset metadata + score + approval state.Args
NameTypeRequiredDescription
symbolstringyesAsset symbol (e.g. BTC, ETH)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Global market overview (total cap, BTC dominance, 24h change).Args
NameTypeRequiredDescription
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Current price, market cap, volume, 24h/7d change. Optionally pin a provider.Args
NameTypeRequiredDescription
symbolstringyesAsset symbol
providerstringnoOptional data provider override
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
OHLCV bars for an asset. Bar granularity is set by the data provider (typically 1h). No timeframe parameter — the SDK / upstream endpoint don’t support overriding bar size at this call site.Args
NameTypeRequiredDescription
symbolstringyesAsset symbol (e.g. BTC, ETH)
lookback_daysintegernoHistory window in days (default 30)
providerstringnoOptional CEX provider override
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Approved crypto asset universe (agent-safe set).Args
NameTypeRequiredDescription
min_scorenumbernoOptional quality threshold
limitintegernoMax results (default 100)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
On-chain (Nansen + WhaleAlert)

11 tool(s) in this domain.
Net exchange inflows/outflows (selling pressure vs accumulation).Args
NameTypeRequiredDescription
symbolstringnoOptional filter by asset
hours_backintegernoWindow (default 24)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Recent DEX trades from Smart Money wallets (Nansen).Args
NameTypeRequiredDescription
chainsarraynoChain filter.
filtersobjectnoNansen filter dict.
order_byarraynoSort spec.
pageintegernoPage (default 1).
per_pageintegernoItems per page (default 100).
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Smart Money historical holdings snapshots across chains (Nansen).Args
NameTypeRequiredDescription
chainsarraynoChain filter, e.g. [‘ethereum’, ‘solana’]. Default [‘ethereum’].
date_fromstringnoISO date ‘YYYY-MM-DD’.
date_tostringnoISO date ‘YYYY-MM-DD’.
filtersobjectnoNansen filter dict (include_smart_money_labels, etc.)
order_byarraynoSort spec, e.g. [{‘field’: ‘block_timestamp’, ‘direction’: ‘DESC’}]
pageintegernoPage (default 1)
per_pageintegernoItems per page (default 100)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Smart Money perp trades on Hyperliquid (Nansen).Args
NameTypeRequiredDescription
filtersobjectnoNansen filter dict.
order_byarraynoSort spec.
pageintegernoPage (default 1).
per_pageintegernoItems per page (default 100).
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Smart-money sentiment for an asset (aggregate of tracked wallets).Args
NameTypeRequiredDescription
symbolstringyesAsset symbol
chainstringnoOptional chain filter
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
All DEX trades for a single token in a date window (Nansen).Args
NameTypeRequiredDescription
symbolstringyesToken symbol (e.g. ‘uniswap’).
chainstringnoChain (default ‘ethereum’).
date_fromstringnoISO ‘YYYY-MM-DD’.
date_tostringnoISO ‘YYYY-MM-DD’.
filtersobjectnoNansen filter dict.
order_byarraynoSort spec.
pageintegernoPage (default 1).
per_pageintegernoItems per page (default 100).
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Per-wallet-category flow data for a token across a date window (Nansen).Args
NameTypeRequiredDescription
symbolstringyesToken symbol (non-stablecoin).
chainstringnoChain (default ‘ethereum’).
date_fromstringnoISO ‘YYYY-MM-DD’.
date_tostringnoISO ‘YYYY-MM-DD’.
filtersobjectnoNansen filter dict.
order_byarraynoSort spec.
pageintegernoPage (default 1).
per_pageintegernoItems per page (default 100).
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Top holders + distribution for a token.Args
NameTypeRequiredDescription
symbolstringyesAsset symbol
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Whale buying/selling activity for an asset.Args
NameTypeRequiredDescription
symbolstringyesAsset symbol (e.g. ETH)
hours_backintegernoWindow (default 24)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Whale transactions above a USD threshold.Args
NameTypeRequiredDescription
symbolstringnoOptional filter by asset
min_valuenumbernoMin USD value (default 500000)
hours_backintegernoWindow (default 24)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Screen assets smart money is currently accumulating.Args
NameTypeRequiredDescription
chainsarraynoOptional list of chain names
timeframestringnoLookback (default ‘24h’)
limitintegernoMax results (default 20)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
Oracle

18 tool(s) in this domain.
Backtest one strategy through Oracle’s engine (synchronous).Args
NameTypeRequiredDescription
assetstringyese.g. BTC, ETH
intervalstringyese.g. 1h, 4h, 1d
strategy_jsonstringyesStrategy JSON (MangroveAI shape).
lookback_monthsintegernoDefault 12.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Submit an Oracle backtest for async execution. Returns backtest_id to poll.Args
NameTypeRequiredDescription
assetstringyese.g. BTC, ETH
intervalstringyese.g. 1h, 4h, 1d
strategy_jsonstringyesStrategy JSON (MangroveAI shape).
lookback_monthsintegernoDefault 12.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Bulk-evaluate N strategies via Oracle with shared market-data fetches.Args
NameTypeRequiredDescription
requestobjectyesOracleBulkBacktestRequest dict (strategy_ids, strategy_configs, shared risk + date fields).
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Poll the status / full result of an async Oracle backtest.Args
NameTypeRequiredDescription
backtest_idstringyesID returned by oracle_backtest_async.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Create an Oracle sweep experiment in draft status.Args
NameTypeRequiredDescription
configobjectyesExperimentConfig dict (name required).
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Query the curated Oracle corpus (results / ohlcv). Whitelist-enforced columns + filter ops; tenancy injected server-side.Args
NameTypeRequiredDescription
tablestringyes’results’ | ‘ohlcv’
selectarray<string>yesColumns to return.
filtersarray<&#123;col,op,value&#125;>noFilter clauses.
order_byarray<string>noOptional ORDER BY clauses.
limitintegernoDefault 100, max 1000.
offsetintegernoDefault 0.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Delete an Oracle experiment and cancel in-flight children.Args
NameTypeRequiredDescription
experiment_idstringyesExperiment to delete.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Get full Oracle experiment config + live progress.Args
NameTypeRequiredDescription
experiment_idstringyesID returned by oracle_create_experiment.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Launch a validated Oracle experiment into up to 99 child backtests.Args
NameTypeRequiredDescription
experiment_idstringyesValidated experiment to launch.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List curated OHLCV datasets available to Oracle experiments.Args
NameTypeRequiredDescription
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List Oracle experiments (summary view) for the calling org.Args
NameTypeRequiredDescription
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Paginated read of Oracle backtest results under an experiment.Args
NameTypeRequiredDescription
experiment_idstringyesExperiment whose results to read.
limitintegernoDefault 100; max 1000.
offsetintegernoDefault 0.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List signals with typed param specs available to Oracle experiments.Args
NameTypeRequiredDescription
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List predefined strategy templates to seed Oracle experiments.Args
NameTypeRequiredDescription
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Pause a running Oracle experiment without losing completed results.Args
NameTypeRequiredDescription
experiment_idstringyesRunning experiment to pause.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Replace a draft Oracle experiment’s config (PUT semantics).Args
NameTypeRequiredDescription
experiment_idstringyesExperiment to update.
configobjectyesFull replacement ExperimentConfig.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Validate a draft Oracle experiment (transition draft -> validated).Args
NameTypeRequiredDescription
experiment_idstringyesDraft experiment to validate.
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Score 1-99 strategies through Mangrove SIEVE before paying for backtests. Returns binary + 4-class probabilities per item, with model + code provenance.Args
NameTypeRequiredDescription
strategiesarray<Strategy>yesMangroveAI-shaped Strategy objects (1-99 items).
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
Signals

4 tool(s) in this domain.
Fetch a single signal’s full metadata + param schema.Args
NameTypeRequiredDescription
signal_namestringyesExact signal name (e.g. ‘rsi_cross_up’)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List / search available signals.Args
NameTypeRequiredDescription
categorystringnoFilter by category
searchstringnoSearch query
limitintegernoMax results
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Semantic match of signals against a natural-language description.Args
NameTypeRequiredDescription
descriptionstringyesNatural-language description of what you want
top_kintegernoMax results (default 5)
similarity_thresholdnumbernoMin similarity (default 0.5)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Text search signals (keyword/name). For intent-based matching, prefer match_signals.Args
NameTypeRequiredDescription
querystringyesText query
limitintegernoPage size (default 50)
offsetintegernoPage offset
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
Strategy

13 tool(s) in this domain.
Backtest a strategy (quick or full). Window precedence: start+end > hours > days > months > timeframe-aware auto (5m-1h=3mo, 4h=6mo, 1d=12mo). config is a single dict that merges over trading_defaults.json — use it for slippage_pct, fee_pct, max_hold_time_hours, initial_balance, max_risk_per_trade, reward_factor, atr_period, or any other BacktestRequest field. Returns full SDK metrics, trade history, and a resolved_window block for fallback detection.Args
NameTypeRequiredDescription
strategy_idstringyesAgent strategy UUID
modestringnoquick | full (default full)
lookback_monthsintegernoWindow in months (auto by timeframe if all window fields omitted)
lookback_daysintegernoWindow in days (overrides lookback_months)
lookback_hoursintegernoWindow in hours — use for short backtests
start_datestringnoISO 8601 — paired with end_date, overrides all lookback_* fields
end_datestringnoISO 8601
configobjectnoMerges over trading_defaults.json (slippage_pct, max_risk_per_trade, initial_balance, reward_factor, atr_*, etc.)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
After search_reference_strategies returns candidates, call this to produce a create_strategy_manual payload. Signals and params are copied exactly — the agent must NOT modify them. timeframe and asset are free overrides: a reference is a portable combo, so retarget onto the user’s asset/TF and bulk-backtest the top matches rather than single-pick by label.Args
NameTypeRequiredDescription
reference_idstringyese.g. ref-001 — from search_reference_strategies
timeframestringnoOverride the reference’s timeframe (canonicalized)
assetstringnoRetarget onto a different asset — reference strategies are portable
namestringnoOptional strategy name override
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Create a strategy from a natural-language goal.Args
NameTypeRequiredDescription
goalstringyesNatural-language goal
assetstringyesAsset symbol
timeframestringyes5m | 15m | 30m | 1h | 4h | 1d (1m not supported)
candidate_countintegerno5-10
backtest_lookback_monthsintegernoDefault: auto by timeframe (5m-1h=3mo, 4h=6mo, 1d=12mo)
seedintegernoReproducibility seed
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Create a strategy with explicit entry/exit rules.Args
NameTypeRequiredDescription
namestringyesStrategy name
assetstringyesAsset symbol
timeframestringyes5m | 15m | 30m | 1h | 4h | 1d (1m not supported)
entryarrayyesEntry rules
exitarraynoExit rules
execution_configobjectnoOverride exec params
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Delete a strategy upstream (local audit trail preserved).Args
NameTypeRequiredDescription
strategy_idstringyesAgent (local) strategy UUID
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Manually trigger one evaluation tick.Args
NameTypeRequiredDescription
strategy_idstringyesAgent strategy UUID
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Fetch a single MangroveAI execution position.Args
NameTypeRequiredDescription
position_idstringyesPosition id
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Get a strategy by ID.Args
NameTypeRequiredDescription
strategy_idstringyesAgent strategy UUID
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List positions on MangroveAI’s execution side (copilot-authored strategies).Args
NameTypeRequiredDescription
account_idstringnoOptional filter
statusstringnoOptional: open | closed | etc
skipintegernoPage offset
limitintegernoPage size
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List trades on MangroveAI’s execution side (copilot-authored strategies).Args
NameTypeRequiredDescription
account_idstringnoOptional filter
assetstringnoOptional asset filter
outcomestringnoOptional outcome filter
skipintegernoPage offset
limitintegernoPage size
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List strategies.Args
NameTypeRequiredDescription
statusstringnoFilter: draft|inactive|paper|live|archived
limitintegernoPage size
offsetintegernoPage offset
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Find curated reference strategies that match the user’s goal and asset. Returns ranked candidates with signals + parameter choices that have worked in backtests. ALWAYS call this before picking signals manually — it’s the primary source of parameter intuition.Args
NameTypeRequiredDescription
assetstringyesAsset symbol (e.g. BTC, ETH)
timeframestringno5m | 15m | 30m | 1h | 4h | 1d
categorystringnomomentum | mean_reversion | trend_following | breakout | volatility
goal_hintstringnoFree text from the user’s goal — auto-detects category if category is not supplied
limitintegernoMax results (default 5)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Transition strategy lifecycle status.Args
NameTypeRequiredDescription
strategy_idstringyesAgent strategy UUID
statusstringyesTarget status
confirmbooleannoRequired for live + live→inactive
allocationobjectnoRequired for live
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
Logs

3 tool(s) in this domain.
All trades across strategies (optional filters).Args
NameTypeRequiredDescription
limitintegernoMax results
strategy_idstringnoFilter
modestringnolive | paper
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Evaluation log for a strategy.Args
NameTypeRequiredDescription
strategy_idstringyesStrategy UUID
limitintegernoPage size
offsetintegernoPage offset
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Trades for a strategy.Args
NameTypeRequiredDescription
strategy_idstringyesStrategy UUID
limitintegernoPage size
offsetintegernoPage offset
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
Knowledge base

5 tool(s) in this domain.
Fetch a KB document by slug (full body, not search snippet).Args
NameTypeRequiredDescription
slugstringyesDocument slug (e.g. ‘momentum-strategies’)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Look up a KB glossary term (definition + backlinks).Args
NameTypeRequiredDescription
termstringyesGlossary term (exact match)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List KB indicator docs (optionally by category).Args
NameTypeRequiredDescription
categorystringnoFilter: momentum | trend | mean_reversion | volatility | volume | pattern
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List KB tags (navigation + kb_search filtering).Args
NameTypeRequiredDescription
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
DeFi

3 tool(s) in this domain.
Total value locked (TVL) in DeFi on a given chain.Args
NameTypeRequiredDescription
chainstringyesChain (e.g. ‘base’, ‘ethereum’)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
TVL for a specific DeFi protocol (e.g. ‘aave’, ‘uniswap’).Args
NameTypeRequiredDescription
protocolstringyesProtocol slug
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Stablecoin supply + flow metrics (macro liquidity proxy).Args
NameTypeRequiredDescription
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
Social

3 tool(s) in this domain.
Influence score for a social username.Args
NameTypeRequiredDescription
usernamestringyesSocial username (no @)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Recent social mentions of a topic (raw posts).Args
NameTypeRequiredDescription
topicstringyesAsset symbol or keyword
hours_backintegernoWindow (default 24)
limitintegernoMax posts (default 20)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
Aggregate social (X/Twitter) sentiment for a topic or asset.Args
NameTypeRequiredDescription
topicstringyesAsset symbol or keyword
hours_backintegernoWindow (default 24)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
Documentation

2 tool(s) in this domain.
Fetch a MangroveAI developer doc by path (API reference, guides).Args
NameTypeRequiredDescription
pathstringyesDoc path (from list_docs)
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).
List MangroveAI developer docs (API reference + guides).Args
NameTypeRequiredDescription
api_keystringyesValid API key
Access: authREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
x402 demo (hello_mangrove)

1 tool(s) in this domain.
x402 demo: $0.05 USDC on Base. Smoke test for the payment path.No arguments.Access: x402 · Price: $0.05 USDC · Network: baseREST mirror: /api/v1/agent/... (see REST mirror for the pattern).

​
REST mirror

Every MCP tool above has a mirrored REST endpoint at /api/v1/agent/<resource>/.... HTTP method matches the underlying call — typically POST for actions, GET for reads. Same service layer, same auth, same response shape. Use REST when the caller isn’t an MCP client. Examples:
  • POST /api/v1/agent/oracle/experiments mirrors the oracle_create_experiment MCP tool.
  • POST /api/v1/agent/on-chain/smart-money/historical-holdings mirrors get_smart_money_historical_holdings.
  • GET /api/v1/agent/oracle/datasets mirrors oracle_list_datasets.
Generated from mangrove-agent/server/src/mcp/tools.py. 90 tools across 14 domains. Re-run python scripts/generate-mcp-tools-catalog.py to refresh.