# Traderspost Mcp

> TradersPost MCP Server

- **Type:** MCP server
- **Install:** `agentstack add mcp-alldadev-traderspost-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [alldadev](https://agentstack.voostack.com/s/alldadev)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [alldadev](https://github.com/alldadev)
- **Source:** https://github.com/alldadev/traderspost-mcp

## Install

```sh
agentstack add mcp-alldadev-traderspost-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# TradersPost MCP Server

The first [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [TradersPost](https://traderspost.io/) — trade stocks, options, futures, and crypto directly from AI assistants like Claude Code, Copilot, and any MCP-compatible client.

## What It Does

This MCP server connects your AI assistant to your TradersPost account via webhooks, giving it the ability to:

- **Send trade signals** (buy, sell, exit, cancel)
- **Place bracket orders** with take profit and stop loss
- **Exit positions** and **cancel open orders**
- **Health check** your webhook connection

Your AI assistant becomes a trading co-pilot that can execute trades on your behalf through any broker connected to TradersPost (Tradovate, TradeStation, Alpaca, Robinhood, Interactive Brokers, and [17+ more](https://traderspost.io/connections)).

## Quick Start

### 1. Install

```bash
git clone https://github.com/alldadev/traderspost-mcp.git
cd traderspost-mcp
npm install
npm run build
```

### 2. Get Your Webhook URL

1. Log into [app.traderspost.io](https://app.traderspost.io)
2. Go to **Strategies** > **New Strategy**
3. Name it, set asset class (e.g., Futures), click **Save**
4. Copy your webhook URL — it looks like:
   ```
   https://webhooks.traderspost.io/trading/webhook/{uuid}/{password}
   ```

### 3. Connect a Broker

1. Go to **Subscriptions** > **New Subscription**
2. Select your strategy, click **Subscribe**
3. Choose your broker (or TradersPost Paper for testing)
4. Set **Auto Submit** to ON
5. Set **Allowed Sides** to Both Sides
6. Click **Save** then **Enable**

### 4. Add to Claude Code

Add to your `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "traderspost": {
      "command": "node",
      "args": ["/path/to/traderspost-mcp/dist/index.js"],
      "env": {
        "TRADERSPOST_WEBHOOK_URL": "https://webhooks.traderspost.io/trading/webhook/{uuid}/{password}"
      }
    }
  }
}
```

Restart Claude Code. The tools are now available.

## Tools

### `send_signal`

Send a trade signal (buy, sell, exit, or cancel).

```
"Buy 2 MES at market"
"Sell 1 ES with a limit at 5650"
"Exit my NQ position"
```

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Symbol (e.g., `MES1!`, `ES1!`, `AAPL`, `BTCUSD`) |
| `action` | string | Yes | `buy`, `sell`, `exit`, or `cancel` |
| `order_type` | string | No | `market` (default), `limit`, or `stop` |
| `limit_price` | number | No | Limit price for limit orders |
| `quantity` | number | No | Number of contracts/shares (default: 1) |

### `bracket_order`

Send an entry order with take profit and stop loss brackets attached.

```
"Buy 1 MES with stop at 5600 and take profit at 5700"
```

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Symbol |
| `action` | string | Yes | `buy` or `sell` |
| `quantity` | number | No | Number of contracts/shares |
| `order_type` | string | No | `market` (default) or `limit` |
| `limit_price` | number | No | Limit entry price |
| `take_profit_price` | number | No | Take profit limit price |
| `stop_loss_price` | number | No | Stop loss trigger price |

### `exit_position`

Flatten all positions for a ticker.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Symbol to exit |

### `cancel_orders`

Cancel all open orders for a ticker.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Symbol to cancel orders for |

### `health_check`

Verify the webhook connection is working. Returns `{ ok: true }` on success.

## Supported Assets

TradersPost supports multiple asset classes. Use the appropriate ticker format:

| Asset | Ticker Format | Examples |
|-------|--------------|----------|
| **Futures** | Continuous: `ES1!`, `NQ1!`, `MES1!` | Auto-maps to front month |
| **Stocks** | Standard symbol | `AAPL`, `TSLA`, `SPY` |
| **Options** | OCC format | `SPY 250624C596` |
| **Crypto** | Pair format | `BTCUSD`, `ETHUSD` |

## Supported Brokers

Tradovate, TradeStation, Alpaca, Robinhood, Interactive Brokers, Webull, tastytrade, E*TRADE, Tradier, Coinbase, Kraken, Binance, Bybit, NinjaTrader, ProjectX, and 30+ prop firms including Topstep, Apex Trader Funding, and more.

Full list: [traderspost.io/connections](https://traderspost.io/connections)

## Configuration

The server requires one environment variable:

| Variable | Description |
|----------|-------------|
| `TRADERSPOST_WEBHOOK_URL` | Your full webhook URL from TradersPost |

## API Reference

This server wraps the [TradersPost Webhook API](https://docs.traderspost.io/docs/core-concepts/signals/webhooks). The webhook supports additional fields beyond what the MCP tools expose:

- `sentiment` — Position bias after trade (`bullish`, `bearish`, `flat`)
- `signalPrice` — Market price at signal time (used for slippage tracking)
- `timeInForce` — Order duration (`day`, `gtc`, `ioc`, `fok`)
- `trailAmount` / `trailPercent` — For trailing stop orders
- `delay` — Postpone execution (seconds)
- `test` — Validate without submitting to broker
- `extras` — Custom metadata for logging

These can be sent via the `send_signal` tool's underlying API. See the [webhook reference](https://docs.traderspost.io/docs/developer-resources/webhook-reference) for full details.

## Rate Limits

TradersPost enforces:
- 60 requests per minute
- 500 requests per hour

## Paper Trading

Start with TradersPost Paper (free, no broker needed) to test your setup before connecting a live account. Create a subscription pointing to "TradersPost Paper" instead of a real broker.

## Roadmap

- [ ] Dashboard scraping for position/trade history reads (Playwright)
- [ ] `get_positions` tool — current open positions
- [ ] `get_trade_log` tool — historical trades with P&L
- [ ] `get_account_status` tool — broker connection health
- [ ] npm publish for `npx traderspost-mcp` install

## License

MIT

## Credits

Built by [Andre Darby](https://github.com/alldadev) with [Claude Code](https://claude.ai/code).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [alldadev](https://github.com/alldadev)
- **Source:** [alldadev/traderspost-mcp](https://github.com/alldadev/traderspost-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-alldadev-traderspost-mcp
- Seller: https://agentstack.voostack.com/s/alldadev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.