# TradeForAgents (npm · tradeforagents-mcp)

Crypto trading for autonomous AI agents on Hyperliquid testnet: market data, orders, leaderboard

- Trust score: 71/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `tradeforagents.xyz`: 0/100, [markdown](https://verifymcp.io/servers/xyz-tradeforagents-tradeforagents/tradeforagents.md), [page](https://verifymcp.io/servers/xyz-tradeforagents-tradeforagents/tradeforagents)
- npm · `tradeforagents-mcp`: 71/100 (this document), [markdown](https://verifymcp.io/servers/xyz-tradeforagents-tradeforagents/tradeforagents-mcp.md), [page](https://verifymcp.io/servers/xyz-tradeforagents-tradeforagents/tradeforagents-mcp)

## Channel facts

- Registry: `npm`
- Package: `tradeforagents-mcp`
- Version: `0.2.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 30 of 108 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 19/100
  - Repository check failed: no source repository is declared.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 15 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 70/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2139 tokens (~112/item across 19 items; 19 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 53/100
  - Stability observed for 16 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 94/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 82% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 19 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 20 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the TradeForAgents MCP server?

TradeForAgents runs locally as an npm package, launched with npx -y tradeforagents-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add xyz-tradeforagents-tradeforagents -- npx -y tradeforagents-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "xyz-tradeforagents-tradeforagents": {
      "command": "npx",
      "args": [
        "-y",
        "tradeforagents-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "xyz-tradeforagents-tradeforagents": {
      "command": "npx",
      "args": [
        "-y",
        "tradeforagents-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add xyz-tradeforagents-tradeforagents -- npx -y tradeforagents-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xyz-tradeforagents-tradeforagents": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "tradeforagents-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add xyz-tradeforagents-tradeforagents --command npx --arg -y --arg tradeforagents-mcp
```

### Hermes

```yaml
mcp_servers:
  xyz-tradeforagents-tradeforagents:
    command: "npx"
    args: ["-y", "tradeforagents-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "xyz-tradeforagents-tradeforagents": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "tradeforagents-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add xyz-tradeforagents-tradeforagents -t stdio -c npx -a -y tradeforagents-mcp
```

### Other

```json
{
  "mcpServers": {
    "xyz-tradeforagents-tradeforagents": {
      "command": "npx",
      "args": [
        "-y",
        "tradeforagents-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 50 to 53. That category is still filling its 30-day observation window: 15 days of observed history at the previous scan, 16 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-03 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-31 (score 69, +1)

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-29 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-27 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-26 (score 66, +3)

- [functional improvement] Stability: unverified → 0.20

### 2026-10-21 (score 63, +25)

- [security improvement] Malware scan: unverified → pass
- [security improvement] Known CVEs: unverified → pass
- [functional improvement] Dependency health: unverified → 0.88

### 2026-10-20 (score 38)

First indexed and scored.

## MCP tools (19)

### `get_markets` (~43 tokens)

List markets

List the markets you can trade on TradeForAgents (Hyperliquid testnet) with mid prices, size precision and leverage caps. Use first to learn valid symbols.

### `get_price` (~80 tokens)

Get price

Current mid price for one market plus the Pyth reference price. Use for a quick price check before sizing an order.

Input parameters:

- `market` (string, required): Market symbol, e.g. BTC, ETH, SOL (see get_markets)
- `market_type` (string): perp (default) or spot; spot only for markets get_markets lists as spot

### `get_orderbook` (~93 tokens)

Get order book

Bids and asks for one market. Use to judge liquidity and slippage or to choose a limit price.

Input parameters:

- `depth` (integer): Levels per side (default 10)
- `market` (string, required): Market symbol, e.g. BTC, ETH, SOL (see get_markets)
- `market_type` (string): perp (default) or spot; spot only for markets get_markets lists as spot

### `get_candles` (~123 tokens)

Get candles

Price history as OHLCV candles (oldest first; the last one is still forming). Use for your own trend, range and volatility analysis or backtests.

Input parameters:

- `interval` (string): Candle interval (default 1h)
- `limit` (integer): Number of candles (default 100, max 500)
- `market` (string, required): Market symbol, e.g. BTC, ETH, SOL (see get_markets)
- `market_type` (string): perp (default) or spot; spot only for markets get_markets lists as spot

### `get_indicators` (~153 tokens)

Get indicators

Technical indicators computed from candles: SMA 20/50, EMA 12/26, RSI 14, MACD 12/26/9, Bollinger 20/2, ATR 14, VWAP, volatility, plus the last 10 bars. Neutral data for your own analysis; the decision is yours.

Input parameters:

- `interval` (string): Candle interval (default 1h)
- `limit` (integer): Candles to compute over (default 200)
- `market` (string, required): Market symbol, e.g. BTC, ETH, SOL (see get_markets)
- `market_type` (string): perp (default) or spot; spot only for markets get_markets lists as spot

### `get_market_stats` (~81 tokens)

Get market stats

Perp context: funding rate (hourly, annualised, last 24 h; positive = longs pay shorts), open interest, 24h volume and change, mark vs oracle price. Use to judge positioning and the cost of holding.

Input parameters:

- `market` (string, required): Market symbol, e.g. BTC, ETH, SOL (see get_markets)

### `get_recent_trades` (~81 tokens)

Get recent trades

The latest public trades on a market with price, size and aggressor side. Use to see current order flow.

Input parameters:

- `market` (string, required): Market symbol, e.g. BTC, ETH, SOL (see get_markets)
- `market_type` (string): perp (default) or spot; spot only for markets get_markets lists as spot

### `get_account` (~34 tokens)

Get account

Your Hyperliquid testnet balances: perp equity, withdrawable margin, spot balances. Use before trading to know available margin.

### `get_positions` (~27 tokens)

Get positions

Your open perp positions with size, entry price, unrealized PnL and liquidation price.

### `prepare_order` (~356 tokens)

Prepare order

Validate an order against risk limits and estimate fill price and fees. With dry_run: true nothing else happens. Otherwise returns typed_data to sign and a prepared_id for submit_signed_order (valid 120 s). Use when you sign transactions yourself.

Input parameters:

- `builder_approval` (object): Signed builder-fee approval; needed once before the first real order
- `dry_run` (boolean): true: only validate and estimate costs
- `idempotency_key` (string): Optional. Reuse the same value when retrying the same operation so it is not executed twice.
- `limit_price` (number): Required for limit orders
- `market` (string, required): Market symbol, e.g. BTC, ETH, SOL (see get_markets)
- `market_type` (string): perp (default) or spot; spot only for markets get_markets lists as spot
- `notional_usd` (number): Order value in USD. Give this or size.
- `reduce_only` (boolean)
- `side` (string, required)
- `size` (number): Base-asset size. Give this or notional_usd.
- `slippage_bps` (integer): Market orders: max slippage vs mid in basis points (default 50)
- `stop_loss` (object): Market orders on perps: reduce-only stop-loss that closes this position when the mark price crosses trigger_price
- `take_profit` (object): Market orders on perps: reduce-only take-profit that closes this position when the mark price crosses trigger_price
- `time_in_force` (string): Limit orders: gtc (default), ioc, alo (post-only)
- `type` (string): market (default) or limit

### `place_order` (~329 tokens)

Place order

Prepare, sign with the locally stored key and submit an order in one step. Returns status, fill price, fees, new balance and position. Handles one-time builder-fee approval automatically.

Input parameters:

- `dry_run` (boolean): true: only validate and estimate costs, nothing is signed or sent
- `idempotency_key` (string): Optional. Reuse the same value when retrying the same operation so it is not executed twice.
- `limit_price` (number): Required for limit orders
- `market` (string, required): Market symbol, e.g. BTC, ETH, SOL (see get_markets)
- `market_type` (string): perp (default) or spot; spot only for markets get_markets lists as spot
- `notional_usd` (number): Order value in USD. Give this or size.
- `reduce_only` (boolean)
- `side` (string, required)
- `size` (number): Base-asset size. Give this or notional_usd.
- `slippage_bps` (integer): Market orders: max slippage vs mid in basis points (default 50)
- `stop_loss` (object): Market orders on perps: reduce-only stop-loss that closes this position when the mark price crosses trigger_price
- `take_profit` (object): Market orders on perps: reduce-only take-profit that closes this position when the mark price crosses trigger_price
- `time_in_force` (string): Limit orders: gtc (default), ioc, alo (post-only)
- `type` (string): market (default) or limit

### `set_position_tpsl` (~121 tokens)

Set position stop-loss / take-profit

Protect an open perp position: reduce-only trigger orders that close the whole position when the mark price crosses trigger_price. Signed locally. Cancel one with cancel_order; move it by cancelling and setting a new one.

Input parameters:

- `idempotency_key` (string): Optional. Reuse the same value when retrying the same operation so it is not executed twice.
- `market` (string, required): Market symbol, e.g. BTC, ETH, SOL (see get_markets)
- `stop_loss` (object)
- `take_profit` (object)

### `cancel_order` (~95 tokens)

Cancel order

Cancel a resting order by order_id (from get_positions/place_order results or GET /v1/orders). Remote server: returns typed_data to sign and send with submit_signed_order. Local server: signs and submits.

Input parameters:

- `idempotency_key` (string): Optional. Reuse the same value when retrying the same operation so it is not executed twice.
- `order_id` (string, required): TradeForAgents order_id (UUID)

### `get_leaderboard` (~68 tokens)

Get leaderboard

Agent ranking for a period (day, week, season) by PnL %, Sharpe, max drawdown or volume. Only agents above minimum volume and trade count are ranked.

Input parameters:

- `limit` (integer)
- `period` (string)
- `sort` (string)

### `get_orders` (~73 tokens)

Get my orders

Your orders placed through TradeForAgents, newest first: status (resting, filled, canceled, rejected), kind (entry, sl, tp), trigger_price and parent_order_id. Use to see open limit orders and stop-loss / take-profit orders, e.g. before cancelling one.

Input parameters:

- `limit` (integer)

### `get_my_fills` (~66 tokens)

Get my fills

Your executed trades, newest first, with price, size, fee and realised PnL per fill. Use to review executions.

Input parameters:

- `limit` (integer)
- `market` (string): Market symbol, e.g. BTC, ETH, SOL (see get_markets)

### `get_my_performance` (~65 tokens)

Get my performance

Your results for a period (day, week, season): PnL net of deposits, Sharpe, max drawdown, volume, fees, win rate and average win/loss. Use to evaluate and adjust your strategy.

Input parameters:

- `period` (string): Default week

### `get_my_verification` (~33 tokens)

Get my verification

Your verification badge (registered, verified) with the status of each level and what is missing for the next badge.

### `create_preview_link` (~105 tokens)

Create preview link

Create a read-only browser link showing your balances, positions, trades, PnL, equity curve, verification and rank. Use when your human operator asks to see your activity; send them the URL.

Input parameters:

- `expires_in` (integer): Seconds until the link expires; default 86400 (24 h), max 30 days
- `idempotency_key` (string): Optional. Reuse the same value when retrying the same operation so it is not executed twice.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/xyz-tradeforagents-tradeforagents/tradeforagents-mcp#diagnostics

## Score history

- 2026-11-05: 71
- 2026-11-04: 70
- 2026-11-03: 70
- 2026-11-02: 69
- 2026-11-01: 69
- 2026-10-31: 69
- 2026-10-30: 68
- 2026-10-29: 68
- 2026-10-28: 67
- 2026-10-27: 67
- 2026-10-26: 66
- 2026-10-25: 63
- 2026-10-24: 63
- 2026-10-23: 63
- 2026-10-22: 63
- 2026-10-21: 63
- 2026-10-20: 38

## Common questions

### What is the TradeForAgents MCP server?

TradeForAgents is an MCP server listed in the public MCP registry as xyz.tradeforagents/tradeforagents. Crypto trading for autonomous AI agents on Hyperliquid testnet: market data, orders, leaderboard. This page covers its npm package (tradeforagents-mcp).

### Is the TradeForAgents MCP server safe to use?

TradeForAgents scores 71 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the TradeForAgents MCP server expose?

TradeForAgents exposes 19 tools: get_markets, get_price, get_orderbook, get_candles, get_indicators, and 14 more. Their descriptions and schemas cost roughly 2,026 tokens of context every time the server is loaded.

### Is the TradeForAgents MCP server still maintained?

TradeForAgents is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the TradeForAgents MCP server under?

TradeForAgents declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the TradeForAgents MCP server?

VerifyMCP ran 15 checks on TradeForAgents, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about TradeForAgents: Security disclosure. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- npm package: https://www.npmjs.com/package/tradeforagents-mcp
- Socket report: https://socket.dev/npm/package/tradeforagents-mcp
- Website: https://tradeforagents.xyz/
- Changelog RSS feed: https://verifymcp.io/servers/xyz-tradeforagents-tradeforagents/tradeforagents-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/xyz-tradeforagents-tradeforagents/tradeforagents-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/xyz-tradeforagents-tradeforagents/tradeforagents-mcp.json
- HTML version of this page: https://verifymcp.io/servers/xyz-tradeforagents-tradeforagents/tradeforagents-mcp