English Français العربية

ai.tradesearcher/mcp-server

Official registry Developer tools

Search TradeSearcher strategies and backtests from Claude Code, Cursor, Codex, and other agents.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @tradesearcher/mcp-server
Claude Code 
claude mcp add ai-tradesearcher-mcp-server -e 'TRADESEARCHER_API_KEY=<your tradesearcher_api_key>' -- npx -y @tradesearcher/mcp-server@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ai-tradesearcher-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@tradesearcher/mcp-server@0.1.1"
            ],
            "env": {
                "TRADESEARCHER_API_KEY": "<your tradesearcher_api_key>"
            }
        }
    }
}

Environment variables

  • TRADESEARCHER_API_KEY required secret Personal API key created at https://tradesearcher.ai/app/account/my-account#agent-api-keys

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. TradeSearcher Agent Tools
  2. Install
  3. CLI
  4. MCP tools
  5. Release check

TradeSearcher Agent Tools

Use TradeSearcher strategies and existing backtests inside Claude Code, Codex, Cursor, and other coding agents.

Documentation: https://docs.tradesearcher.ai/developer-tools/ · Create an API key: https://tradesearcher.ai/app/account/my-account#agent-api-keys

Install

npm install -g @tradesearcher/cli

For MCP:

{
  "mcpServers": {
    "tradesearcher": {
      "command": "npx",
      "args": ["-y", "@tradesearcher/mcp-server"],
      "env": {
        "TRADESEARCHER_API_KEY": "your_api_key"
      }
    }
  }
}

CLI

tradesearcher auth login
tradesearcher auth status
tradesearcher search BTCUSD
tradesearcher best AAPL
tradesearcher backtest 12345 --details --trades --trade-limit 20
tradesearcher strategy 6789 --source
tradesearcher export 12345 --pine --out strategy.pine
tradesearcher compare 12345 67890
tradesearcher schema
tradesearcher schema backtest

Useful search sorts:

tradesearcher search BTCUSD --sort sharpe
tradesearcher search BTCUSD --sort profitFactor
tradesearcher search BTCUSD --sort roi
tradesearcher search BTCUSD --sort latestTradeDate
tradesearcher search BTCUSD --sort robustness

--equity can return large JSON arrays. Use it after narrowing to final candidates.

Use tradesearcher schema to print JSON command schemas for agents. Use tradesearcher schema backtest or tradesearcher schema strategy for one command.

Search, best, and compare rows show source available, source no, or source private when TradeSearcher knows whether Pine source text is available. available means TradeSearcher has source text for the strategy; it does not prove that the text is a complete standalone Pine strategy.

Export Pine source for a backtest strategy:

tradesearcher export 12345 --pine --out strategy.pine

Free accounts hide high-performance backtests with a profit factor above 3. Premium shows these stronger backtests, more results, recent trades, and full strategy details.

Upgrade: https://tradesearcher.ai/app/premium

MCP tools

See docs/mcp-tools.md or the public reference at https://docs.tradesearcher.ai/developer-tools/mcp-server for tool schemas, examples, and the recommended agent workflow.

Per-client setup: Claude Code · Codex.

Release check

Before publishing:

npm run release:check

See docs/release.md for the publish order.

Frequently asked questions

What is ai.tradesearcher/mcp-server?

Search TradeSearcher strategies and backtests from Claude Code, Cursor, Codex, and other agents.

How do I install ai.tradesearcher/mcp-server?

It runs on your machine. In Claude Code: claude mcp add ai-tradesearcher-mcp-server -e 'TRADESEARCHER_API_KEY=<your tradesearcher_api_key>' -- npx -y @tradesearcher/mcp-server@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ai.tradesearcher/mcp-server need an API key?

Yes. It expects TRADESEARCHER_API_KEY, which you set in its configuration.

Is ai.tradesearcher/mcp-server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ai.tradesearcher/mcp-server?

It is published by vnguyen42. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.