MangroveTrader Plugin for Claude Code
MangroveTrader is a social trading leaderboard where traders post trades on Twitter, positions are tracked against real market data, and performance is scored daily.
This plugin connects Claude Code to the MangroveTrader MCP server, giving you 13 slash commands and 10 MCP tools for stats, leaderboard, trade history, and more.
Website: mangrovetraders.com
Twitter: @MangroveTrader
Discord: Join our community
Source: github.com/MangroveTechnologies/mangrove-trader-plugin
Install
git clone https://github.com/MangroveTechnologies/mangrove-trader-plugin.git
claude plugin marketplace add ./mangrove-trader-plugin
claude plugin install mangrove-trader
Or load for a single session without installing:
claude --plugin-dir ./mangrove-trader-plugin
Commands
All commands are prefixed with /mt-:
| Command | Description | Access |
|---|
/mt-track | Compose a trade tweet | Free |
/mt-stats | Your score, rank, open positions | Free |
/mt-report | Performance breakdown (return, Sharpe, drawdown) | Free |
/mt-last | Most recent trade and total count | Free |
/mt-history | Trade history | Free (own) / Paid $0.01/3 trades (others) |
/mt-leaderboard | Full rankings (top 5 free on Twitter) | Paid ($0.25+ USDC) |
/mt-search | Find a trader by handle or name | Paid ($0.02 USDC) |
/mt-cancel | Cancel last trade (5-min window) | Free |
/mt-watch | Watch a trader | Free |
/mt-unwatch | Unwatch a trader | Free |
/mt-set-handle | Set your Twitter handle for this session | Free |
/mt-status | Server health | Free |
/mt-help | List all commands | Free |
MCP Tools
The plugin connects to MangroveTrader's MCP server at https://api.mangrovetraders.com/mcp/. 10 tools available:
| Tool | Access | Price | Notes |
|---|
trader_login | Free | -- | Start X OAuth 2.0 — returns a verification URL |
trader_my_stats | Free | -- | Requires auth_token (MT_AUTH_TOKEN) |
trader_performance_report | Free | -- | Requires auth_token |
trader_last_trade | Free | -- | Public — accepts any twitter_handle |
trader_cancel_last | Free | -- | Requires auth_token |
trader_watch | Free | -- | Requires auth_token |
trader_unwatch | Free | -- | Requires auth_token |
trader_get_leaderboard | x402 | $0.25+ USDC | Top 5 free on Twitter |
trader_search_trader | x402 | $0.02 USDC | -- |
trader_get_trade_history | Free / x402 | Free (own w/ auth_token) / $0.01/3 trades (others) | -- |
How Trading Works
- Tweet your trade to @MangroveTrader on Twitter (use
/mt-track to compose)
- A Grok-powered agent parses your trade and tracks the position
- Positions are marked-to-market against real prices every 5 minutes
- Scoring runs daily at midnight UTC
Tweet Format
@MangroveTrader long 100 AAPL @ 185.50 # Equities
@MangroveTrader enter long 2.5 BTC @ 64000 # Crypto
@MangroveTrader exit short 5 ES @ 5250 # Futures
Scoring
| Component | Weight | Metric |
|---|
| Return | 50% | Total return percentage |
| Consistency | 30% | Sharpe ratio |
| Risk Management | 20% | Max drawdown (lower is better) |
x402 Payments
Paid tools use the x402 protocol for micropayments:
- Network: Base (Coinbase L2)
- Currency: USDC
- Flow: Call without payment -> see price -> confirm -> sign payment -> call with payment
- Safety: You are never charged if data retrieval fails
- API key bypass:
X-API-Key header on REST endpoints skips x402
For agents with wallets: use the x402 SDK or MangroveMarkets TypeScript SDK to sign payments.
For Claude Code users without wallets: free tools work without payment. Paid data available via REST API with an API key.
Security and Privacy
This plugin connects to a remote MCP server hosted on GCP Cloud Run. Here is what it does and does not do:
