# TradeOS (test)

Brings TradeOS market intelligence into AI assistants. It handles ticker searches, spread comparisons, and chart technical analysis directly from chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Author: TradeOS-AI
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TradeOS-AI/tradeos-mcp
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/mcp/tradeos-test

## What it does

This server acts as a bridge between your editor and the TradeOS analytics platform. It equips your assistant with tools to inspect price charts and evaluate live bid-ask spreads. You can also dispatch queries to your personal trading agents without leaving the terminal.

Connection works either over remote HTTP or through a local stdio process provided by `@tradeos/tradeos-mcp`. Running locally requires Node.js 18 or newer. Without a valid `TRADEOS_ACCESS_TOKEN` passed in the environment, the stdio bridge rejects incoming tool calls.

On Windows, executing the stdio bridge via npx often breaks due to npm cache path conflicts. Installing the package into a fixed local folder and referencing the built entrypoint directly keeps the connection stable.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://ai.tradeos.xyz/api/agent/mcp-call`
- Environment variables: `TRADEOS_ACCESS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http tradeos-mcp-test https://ai.tradeos.xyz/api/agent/mcp-call
```

2. **Platform CLI**
```bash
claude mcp add --env TRADEOS_ACCESS_TOKEN=<TRADEOS_ACCESS_TOKEN> --transport stdio tradeos-test -- npx -y @tradeos/tradeos-mcp-test
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add tradeos-test --url https://ai.tradeos.xyz/api/agent/mcp-call
```

2. **Platform CLI**
```bash
codex mcp add tradeos-test --env TRADEOS_ACCESS_TOKEN=<TRADEOS_ACCESS_TOKEN> -- npx -y @tradeos/tradeos-mcp-test
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tradeos-test": {
            "url": "https://ai.tradeos.xyz/api/agent/mcp-call"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tradeos-test": {
            "command": "npx",
            "args": [
                "-y",
                "@tradeos/tradeos-mcp-test"
            ],
            "env": {
                "TRADEOS_ACCESS_TOKEN": "<TRADEOS_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tradeos-test": {
            "type": "http",
            "url": "https://ai.tradeos.xyz/api/agent/mcp-call"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tradeos-test": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tradeos/tradeos-mcp-test"
            ],
            "env": {
                "TRADEOS_ACCESS_TOKEN": "<TRADEOS_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http tradeos-test https://ai.tradeos.xyz/api/agent/mcp-call
```

2. **Platform CLI**
```bash
gemini mcp add -e TRADEOS_ACCESS_TOKEN=<TRADEOS_ACCESS_TOKEN> tradeos-test npx -y @tradeos/tradeos-mcp-test
```
Replace <…> with your own values

## When to use it
- search ticker symbols and compare market spreads
- generate technical analysis for asset charts
- fetch recent macroeconomic developments
- send prompts to custom TradeOS agents

## Example prompts
- Check current spreads and market conditions for SOL.
- Run technical chart analysis on the daily BTC timeframe.
- Summarize major macroeconomic headlines affecting markets today.

## Similar
- [okx-cex-market](https://affpapa.org/en/nevibecode/skills/okx-cex-market.md) — skill · 10500 installs
- [alva](https://affpapa.org/en/nevibecode/skills/alva.md) — skill · 800 installs
- [market-analyst-master](https://affpapa.org/en/nevibecode/skills/market-analyst-master.md) — skill · 417 installs
- [TickDB Market Data](https://affpapa.org/en/nevibecode/mcp/tickdb-market-data.md) — MCP server · ★ 893
- [Wudao A-Share Stock Data MCP](https://affpapa.org/en/nevibecode/mcp/wudao-a-share-stock-data-mcp.md) — MCP server · ★ 11
- [CPZAI](https://affpapa.org/en/nevibecode/mcp/cpzai.md) — MCP server · ★ 1

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md