MangroveTrader

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Social trading leaderboard. 9 MCP tools, x402 micropayments (USDC on Base).

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "MangroveTrader": {
      "url": "https://api.mangrovetraders.com/mcp/",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• trader_login

  Use this when you need to sign in before calling a tool that takes an auth_token and MT_AUTH_TOKEN is not set. Returns a link to verify your X identity and the command that saves the session token, which stays valid for 30 days.

  Hints: read-only no · destructive no · idempotent no · open-world no

• trader_my_stats read-only

  Use this for a quick snapshot of your own standing: composite score, rank, total trades, qualified status and open positions (free, own account only). For returns, drawdown and win rate use trader_performance_report; for other traders use trader_search_trader.

  Parameters:

  • auth_token (required) — string — Session token for your X-verified account. Read it from the MT_AUTH_TOKEN environment variable; if it is not set, call trader_login first.
  • twitter_handle — Optional. Your own X handle, with or without @. Must match the account the auth_token belongs to, otherwise the call returns PAYMENT_REQUIRED.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• trader_performance_report read-only

  Use this when you want a detailed breakdown of your own results over a timeframe: return statistics, volatility, Sharpe ratio, maximum drawdown, win rate, composite score and the scoring weights. For a quick score and rank check use trader_my_stats.

  Parameters:

  • auth_token (required) — string — Session token for your X-verified account. Read it from the MT_AUTH_TOKEN environment variable; if it is not set, call trader_login first.
  • timeframe — string — Reporting period: daily, weekly, monthly, all_time, 7d or 30d (7d is weekly, 30d is monthly). Defaults to all_time.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• trader_last_trade read-only

  Use this when you want to see a trader's most recent trade (action, symbol, quantity, price, time) and their total trade count; free, no auth_token, works for any trader. It returns one trade only, so for a list of trades use trader_get_trade_history.

  Parameters:

  • twitter_handle (required) — string — X handle of the trader to look up, with or without @.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• trader_cancel_last destructive

  Use this when you made a mistake and want to undo your most recent trade; it deletes the trade and updates your position, but only within 5 minutes of it being made, and the deletion cannot be undone. Acts only on your own account.

  Parameters:

  • auth_token (required) — string — Session token for your X-verified account. Read it from the MT_AUTH_TOKEN environment variable; if it is not set, call trader_login first.

  Hints: read-only no · destructive yes · idempotent no · open-world no

• trader_watch

  Use this when you want to add a trader to your watchlist; returns your updated watch count (activity notifications are not available yet). You must have made a trade yourself and cannot watch yourself; to remove a trader use trader_unwatch.

  Parameters:

  • auth_token (required) — string — Session token for your X-verified account. Read it from the MT_AUTH_TOKEN environment variable; if it is not set, call trader_login first.
  • target_handle (required) — string — X handle of the trader to add to your watchlist, with or without @.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• trader_unwatch

  Use this when you want to remove a trader from your watchlist; returns a confirmation and is safe to repeat. To add a trader use trader_watch.

  Parameters:

  • auth_token (required) — string — Session token for your X-verified account. Read it from the MT_AUTH_TOKEN environment variable; if it is not set, call trader_login first.
  • target_handle (required) — string — X handle of the trader to remove from your watchlist, with or without @.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• trader_get_leaderboard

  Use this when you want the ranked list of top traders for a timeframe; paid with x402 ($0.25 USDC on Base for up to 100 rows, plus $0.01 per 4 more rows, maximum 500; call without payment to see the exact price). To look up one trader use trader_search_trader or trader_last_trade.

  Parameters:

  • limit — integer — Number of rows to return, 1 to 500. Defaults to 100; the price rises above 100 rows.
  • payment — string — Base64-encoded x402 payment signature. Leave empty on the first call to receive the price and payment requirements, then call again with the signed payment.
  • timeframe — string — Leaderboard period: daily, weekly, monthly, all_time, 7d or 30d (7d is weekly, 30d is monthly). Defaults to all_time.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• trader_search_trader

  Use this when you want to find a trader by X handle or display name; returns up to 50 matches with handle, name, score, rank, trade count and qualified status. Paid with x402 ($0.02 USDC on Base; call without payment first to get the requirements). For the full ranking use trader_get_leaderboard.

  Parameters:

  • query (required) — string — Text to match against trader handles and display names. Maximum 100 characters; letters, digits, @, - and spaces are used, other characters are dropped.
  • limit — integer — Maximum number of results, 1 to 50. Defaults to 20.
  • payment — string — Base64-encoded x402 payment signature. Leave empty on the first call to receive the price and payment requirements, then call again with the signed payment.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• trader_get_trade_history

  Use this when you want a trader's list of trades, newest first (action, symbol, asset class, quantity, price, time); free for your own trades with auth_token, otherwise $0.01 USDC per 3 trades with x402 on Base (call without payment to see the price). For only the latest trade use trader_last_trade.

  Parameters:

  • twitter_handle (required) — string — X handle of the trader whose trades you want, with or without @.
  • limit — integer — Number of most recent trades to return, up to 1000. 0 (the default) returns all trades. For someone else's history the price scales with this number.
  • payment — string — Base64-encoded x402 payment signature. Leave empty on the first call to receive the price and payment requirements, then call again with the signed payment.
  • auth_token — string — Optional. Your session token from MT_AUTH_TOKEN. If it belongs to twitter_handle, the history is free and no payment is needed.

  Hints: read-only no · destructive no · idempotent no · open-world yes

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.