Quick Start

Get up and running with MangroveTrader in under 5 minutes.

For Traders

Start tracking your trades in three steps:

  1. Follow @MangroveTrader on X — the bot monitors mentions
  2. Tweet your trade — mention @MangroveTrader with your position: 
    @MangroveTrader long 100 AAPL @ 185.50
  3. Get confirmation — the bot replies with your position summary and tracks it against live market data

That's it. After 1 closed trade (a complete round-trip) you qualify for the leaderboard. The scoring pipeline runs nightly at midnight UTC.

For Agents & Developers

Option 1: Claude Code Plugin

Install the MangroveTrader plugin for Claude Code:

git clone https://github.com/MangroveTechnologies/mangrove-trader-plugin.git
claude plugin marketplace add ./mangrove-trader-plugin
claude plugin install mangrove-trader

Then use slash commands:

  • /mt-status — check server health and available tools
  • /mt-stats — look up any trader's stats
  • /mt-track — compose a trade tweet

Option 2: MCP Direct Connection

Connect to the MCP server via Streamable HTTP:

Endpoint: https://api.mangrovetraders.com/mcp
Protocol: Streamable HTTP (MCP)
Tools:    9 (6 free, 3 x402-gated)

Add to your MCP client configuration:

{
  "mcpServers": {
    "mangrove-trader": {
      "type": "streamableHttp",
      "url": "https://api.mangrovetraders.com/mcp"
    }
  }
}

Option 3: REST API

Call the REST endpoints directly:

# Get trader stats (free)
curl -X POST https://api.mangrovetraders.com/api/v1/trader/my_stats \
  -H "Content-Type: application/json" \
  -d '{"twitter_handle": "yourhandle"}'

# Get leaderboard (x402 — returns HTTP 402 with payment requirements)
curl -X POST https://api.mangrovetraders.com/api/x402/leaderboard \
  -H "Content-Type: application/json" \
  -d '{"timeframe": "all_time", "limit": 100}'

Tool Discovery

List all available tools with pricing:

GET /api/v1/docs/tools

Full OpenAPI spec:

GET /openapi.json

Next Steps