mcpField
T
tradesearcher

tradesearcher

Local
github.com/vnguyen42Finance0Updated 14w ago
Repository

About tradesearcher

tradesearcher provides CLI and MCP tools for coding agents to search TradeSearcher strategies and inspect existing backtests. It also supports comparing results and exporting Pine source when available.

Key features

  1. 01Search strategies by symbol
  2. 02Sort results by performance metrics
  3. 03Inspect backtests and trades
  4. 04Compare backtests
  5. 05Export Pine source
  6. 06Print JSON command schemas

Use cases

  1. 01Find strategies for a market symbol
  2. 02Review backtest details and trades
  3. 03Compare two backtest results
  4. 04Export available strategy source

MCP support

The MCP server exposes TradeSearcher search, strategy, and backtest operations to MCP clients. It is configured with a TradeSearcher API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "ai-tradesearcher": {
      "command": "npx",
      "args": [
        "-y",
        "@tradesearcher/mcp-server"
      ],
      "env": {
        "TRADESEARCHER_API_KEY": "<TRADESEARCHER_API_KEY>"
      }
    }
  }
}
Run commandnpx -y @tradesearcher/mcp-server
Environment variables to set
TRADESEARCHER_API_KEYSecretPersonal API key created at https://tradesearcher.ai/app/account/my-account#agent-api-keys

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@tradesearcher/mcp-server0.1.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.