@tradesearcher/mcp-server

MCP server for Claude Code, Codex, Cursor, and other coding agents.

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

npx -y @tradesearcher/mcp-server

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

Tool responses include simple limit text and the Premium upgrade link when the account is limited.

Common tool calls

Search symbols before searching backtests when the user gives a company name or ambiguous ticker:

{
  "name": "search_symbols",
  "arguments": { "query": "Apple", "limit": 5 }
}

Find top candidates:

{
  "name": "get_best_for_symbol",
  "arguments": { "symbol": "AAPL", "limit": 5 }
}

Inspect one backtest without flooding context. includeEquityCurve can return thousands of points, so use it after narrowing to final candidates:

{
  "name": "get_backtest",
  "arguments": { "id": 12345, "includeTrades": true, "tradeLimit": 20, "includeEquityCurve": true }
}

Backtest and compare rows include strategy.sourceAvailability when known:

• available: source text is available to this account. This does not prove the text is a complete standalone Pine strategy.
• no: source code is not available for this strategy
• private: source exists but this account cannot view it

The public repo also includes docs/mcp-tools.md with the same workflow.

Tool schemas

search_symbols

{
  "query": "string",
  "limit": "number, optional"
}

search_backtests

Allowed sort values: sharpe, sharpeRatio, profitFactor, roi, netProfitPercent, latestTradeDate, robustness.

{
  "symbol": "string, optional",
  "market": "crypto | stock | forex | futures, optional",
  "timeframe": "string, optional",
  "strategyType": "intraday | swing | longTerm, optional",
  "minSharpe": "number, optional",
  "minProfitFactor": "number, optional",
  "maxDrawdown": "number, optional",
  "sort": "sharpe | sharpeRatio | profitFactor | roi | netProfitPercent | latestTradeDate | robustness, optional",
  "order": "desc | asc, optional",
  "limit": "number, optional"
}

get_best_for_symbol

{
  "symbol": "string",
  "limit": "number, optional"
}

get_backtest

{
  "id": "number",
  "includeTrades": "boolean, optional",
  "tradeLimit": "number, optional; default 20 when includeTrades is true",
  "includeEquityCurve": "boolean, optional"
}

get_strategy

{
  "id": "number",
  "includeSourceCode": "boolean, optional"
}

When includeSourceCode is true and source is available, the response includes sourceCode.

compare_backtests

{
  "ids": ["number"]
}

get_account_status

{}