MCP server

Connect AlpaTrade to your AI client.

A public Model Context Protocol server for AlpaTrade strategies and agent discovery. Connect once, then ask your client to search strategies, inspect performance and read published strategy skills.

https://alpatrade.chat/mcp

Streamable HTTP · no sign-in · read-only public data

4read-only tools
0API keys needed
1HTTPS endpoint
APIauthenticated actions below
Works with

Claude Code · Cursor · any client that supports MCP over streamable HTTP

Connect your client.

Run this command in your terminal:

claude mcp add --transport http alpatrade https://alpatrade.chat/mcp

What the MCP tools can read.

list_public_strategies

Search public strategies with live or clearly marked backtest figures.

get_public_strategy

Read one public strategy's return, period, author and source link.

get_public_strategy_skill

Fetch the public Markdown strategy skill for your agent.

list_agent_interfaces

Discover the agent catalogue and its authenticated API endpoints.

Results link to their public AlpaTrade source. Annualised return is the simple period return × 252 / trading days; backtests are hypothetical. Private account data and trading actions require the authenticated API below.

Developers

Build on the AlpaTrade agent desk.

Call the primary LangChain DeepAgent, research analysts, backtester, validator, paper trader, reconciler, reporter, and durable autonomy pipeline through typed APIs.

https://api.alpatrade.chat
15callable agent interfaces
5capability groups
2JWT and service-key auth modes
Papertrading safety boundary
Command line

Backtest from your terminal.

The alpatrade CLI runs the same backtester as the web desk and writes every run to a dated folder you can diff, re-run and share.

$ alpatrade backtest paper btd-7dp-05sl-1tp-1d-3m
→ 42 trades · win-rate 61% · Sharpe 1.34 · max DD -6.2%
→ artifacts → backtest-results/2026-…_AAPL_buy_the_dip_1d/

Example output — illustrative figures, not a live result.

Command name format

btd-7dp-05sl-1tp-1d-3m reads as: btd buy-the-dip strategy · 7dp 7% dip threshold · 05sl 0.5% stop-loss · 1tp 1% take-profit · 1d 1-day hold · 3m 3-month lookback. Pattern: {strategy}-{param}-…-{lookback}; 0.5% is written 05.

The artifacts folder

Each run lands in backtest-results/<date>_<symbol>_<strategy>_<interval>/: config.json and strategy_spec.json (parameters), trades.csv and round_trips.csv, equity.csv with a benchmark curve, summary.json (trades, win-rate, Sharpe, max drawdown), data_fingerprint.json and fee_source.json, report.md / notes.md, and a run.py that reproduces the run.

Agent catalogue

Choose the right specialist for the job.

Every agent below is callable through a typed HTTP contract. Skills describe stable capabilities; follow the reference link for request bodies, response schemas, examples, authentication, and error responses.

DeepAgent interfaces

3 agents

DeepAgent Assistant

POST

Canonical durable, tenant-safe DeepAgents API with JSON or SSE responses.

POST /v2/deepagents
Portfolio and position analysisMarket news and company researchBacktest and reporting tool routingPaper-account workflow assistance
authenticated·streaming·paper onlySchema & examples →

DeepAgent Assistant (JSON compatibility)

POST

Compatibility JSON chat interface backed by the shared DeepAgents service.

POST /v2/agents/chat/invoke
Legacy request and response shapeTenant-aware DeepAgents routingPublic research for service principals without a tenantSingle-response JSON transport
authenticated·synchronous·paper onlySchema & examples →

DeepAgent Assistant (SSE)

POST

Compatibility SSE chat; anonymous callers receive public research only.

POST /v2/chat
Token-by-token conversational responsesAgent routing eventsTool execution eventsConversation-thread continuity
public·streaming·paper onlySchema & examples →

Research agents

4 agents

Premarket Agent

POST

Read-only premarket scan and ranked mover intelligence.

POST /v2/agents/premarket/invoke
Premarket mover discoveryCatalyst and news synthesisCandidate rankingSaved-scan retrieval
authenticated·synchronous·read onlySchema & examples →

Alpha Growth Agent

POST

Evidence-backed growth-company research report.

POST /v2/agents/alpha-growth/invoke
Growth-quality assessmentFundamental evidence collectionCatalyst and risk analysisPersistent research reports
authenticated·synchronous·read onlySchema & examples →

Alpha Value Agent

POST

Evidence-backed value-company research report.

POST /v2/agents/alpha-value/invoke
Valuation and margin-of-safety reviewFundamental evidence collectionCatalyst and risk analysisPersistent research reports
authenticated·synchronous·read onlySchema & examples →

Alpha Comparison Agent

POST

Growth and value views generated from one shared evidence collection.

POST /v2/agents/alpha-compare/invoke
Shared-evidence company researchGrowth-versus-value comparisonThesis conflict identificationPaired persistent reports
authenticated·synchronous·read onlySchema & examples →

Analysis and validation

4 agents

Backtest Agent

POST

Run the parameter-grid backtest and return the best configuration.

POST /v2/backtest
Strategy parameter sweepsHistorical performance analysisRisk and drawdown metricsBest-configuration selection
authenticated·synchronous·read onlySchema & examples →

Validation Agent

POST

Validate stored backtest or paper trades against market data.

POST /v2/validate
Trade-price verificationAnomaly detectionFill correction checksValidation suggestions
authenticated·synchronous·read onlySchema & examples →

Report Agent

GET

Return run summaries, detail, P&L, and ranked strategies.

GET /v2/report
Run summary reportingP&L breakdownsStrategy rankingPerformance metric retrieval
authenticated·synchronous·read onlySchema & examples →

Daily Trading Advisor

GET

Read persisted, evidence-gated paper strategy and risk reviews.

GET /v2/advisor/reports
Broker-versus-strategy P&L attributionEvidence-gated loss classificationStored strategy-test recommendationsDaily multi-account advisory history
authenticated·synchronous·read onlySchema & examples →

Paper trading operations

2 agents

Paper Trade Agent

POST

Start a durable paper-trading subprocess and return immediately.

POST /v2/paper
Durable paper-strategy executionConfigurable polling and durationPDT-aware trade controlsBackground run monitoring
authenticated·asynchronous·paper onlySchema & examples →

Reconciliation Agent

POST

Compare the position ledger with the linked Alpaca paper account.

POST /v2/reconcile
Position-ledger reconciliationTrade mismatch detectionMissing and extra fill checksBroker-versus-database P&L comparison
authenticated·synchronous·paper onlySchema & examples →

Agent orchestration

2 agents

Five-Agent Orchestrator

POST

Run backtest, validation, paper trading, and reporting as one workflow.

POST /v2/full
Multi-agent workflow coordinationBacktest-to-paper promotionPhase status aggregationEnd-to-end run reporting
authenticated·synchronous·orchestrationSchema & examples →

Autonomy Scout

POST

Scan candidates and enqueue the durable paper-only agent pipeline.

POST /v2/agents/autonomy-scout/invoke
Market candidate scoutingStrategy-aware candidate rankingDurable autonomy-run enqueueingPaper-only account isolation
authenticated·asynchronous·paper onlySchema & examples →
Documentation

Human guides and machine contracts.

Use ReDoc for reading and Swagger UI for interactive calls. OpenAPI and catalogue JSON remain machine-readable for SDK generators, agents, and service discovery.

Machine-readable: OpenAPI JSON · Agent catalogue JSON

Authentication

User JWTs and service API keys.

User clients send an Authorization bearer token obtained from /auth/login. Trusted services send X-API-Key and include X-User-Id when acting for a user. All trading and autonomy routes are paper-only.