WorldQuant BRAIN MCP Server
duy0699cat/worldquant-brain-mcp
Automatize pesquisa alpha e simulações no WorldQuant BRAIN via MCP
Ver no GitHubServidor MCP para automação de workflows de pesquisa alpha na plataforma WorldQuant BRAIN. Oferece cliente API assíncrono, laboratório de simulação em batch, parser de expressões baseado em AST com detecção de novidade, e pipeline de ingestão de PDFs. Projeto independente e não oficial.
Instalação
npx convez-ai duy0699cat/worldquant-brain-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de workflows de desenvolvimento de alphas
- Simulação em batch de expressões e ranking de resultados
- Ingestão e busca em documentação técnica da plataforma
- Geração de variantes de expressões com detecção de novidade
Veredito

Ferramenta especializada para pesquisadores quantitativos no ecossistema WorldQuant. Bem estruturada como MCP server com suporte a ingestão de PDFs, simulação batch e persistência de experimentos, mas requer acesso prévio à plataforma BRAIN e conhecimento técnico em desenvolvimento de alphas.
README
A tradução para o português deste README ainda está na fila.
WorldQuant MCP
A Python MCP server for automating WorldQuant BRAIN alpha-research workflows, plus a local reference pipeline that converts documentation into LLM-friendly artifacts. Built as a personal research-engineering project.
Note: This is an independent, unofficial project and is not affiliated with or endorsed by WorldQuant. WorldQuant's platform documentation is not included in this repository — you supply your own PDF (see Reference ingestion). Use of the BRAIN API is subject to WorldQuant's own terms.
Status
Initial working scaffold in place.
Current capabilities:
- Load credentials from
.envorWQ_BRAIN_*environment variables. - Convert scanned or text-based PDFs into markdown and chunked JSON.
- Authenticate against
api.worldquantbrain.com. - Search local operator/reference material.
- Fetch platform operators, account details, and data fields.
- Turn text hypotheses into field proxies and expression templates.
- Ingest external research links or notes into mechanism summaries.
- Mutate seed expressions into nearby variants.
- Submit simulations and poll simulation progress.
- Simulate batches of expressions and rank the results.
- Fetch alpha details and submission status.
- Validate whether an alpha is ready to submit and summarize blockers.
- Compare candidate expressions against recent alphas and logged experiments.
- Persist local experiment memory for future agents.
- Submit alphas behind an explicit confirmation flag.
Reference ingestion
The first implemented component is the PDF ingestion pipeline.
.venv/Scripts/python.exe -m pip install -e .
wq-ingest-reference --input wq-ops.pdf
Generated artifacts (produced locally, git-ignored — not committed):
src/worldquant_mcp/reference/data/wq-ops.mdsrc/worldquant_mcp/reference/data/wq-ops.chunks.json
If the PDF has no text layer, the ingester falls back to OCR using in-process Python libraries so it still works on a clean Windows machine.
Running the MCP server
Install the package in editable mode:
.venv/Scripts/python.exe -m pip install -e .
Do not start the stdio MCP server manually if you want to use it from VS Code. VS Code should launch it for you from mcp.json.
Add this to your user-level mcp.json or workspace .vscode/mcp.json:
{
"servers": {
"worldquant-mcp": {
"type": "stdio",
"command": ".venv/Scripts/worldquant-mcp.exe",
"env": {
"WQ_BRAIN_EMAIL": "<your-email>",
"WQ_BRAIN_PASSWORD": "<your-password>"
}
}
}
}
After saving mcp.json, use the VS Code MCP server management UI to reload or start the server. Once it shows as running, the tools from this server become available to Copilot agents.
If you want to run the server yourself for debugging only, use one of these commands:
.venv/Scripts/worldquant-mcp.exe
Or run it via Python:
.venv/Scripts/python.exe -m worldquant_mcp
Timeout behavior
- Polling tools now default to bounded waits instead of open-ended multi-minute blocking.
wait_simulation,batch_simulate, andparallel_mechanism_searchdefault to180seconds.- Override with
timeout_secondswhen you intentionally want a longer or shorter wait. - Set
WQ_BRAIN_MAX_POLL_SECONDSif you want to change the client-wide default used by direct code paths. - 429 handling is now more robust in the shared client: temporary rate limits are retried with bounded backoff, and
CONCURRENT_SIMULATION_LIMIT_EXCEEDEDbacks off more aggressively before failing. - Tune
WQ_BRAIN_RATE_LIMIT_MAX_RETRIESandWQ_BRAIN_RATE_LIMIT_MAX_WAIT_SECONDSif you want stricter or looser retry behavior.
Example session
Once the server is running, an MCP-aware agent calls the tools directly. Illustrative output below (metric values are synthetic and field/alpha names are placeholders — no real platform data is shown):
> healthcheck
{ "status": "ok", "authenticated": true }
> get_platform_operators
[ "rank", "zscore", "ts_delta", "ts_backfill", "ts_decay_linear", "group_zscore", ... ]
> create_simulation expression="rank(<your_signal>)" settings=USA/TOP3000/delay=1
{ "status": "COMPLETE", "alpha_id": "<id>",
"is": { "sharpe": 1.21, "fitness": 0.74, "returns": 0.052, "turnover": 0.11 } }
> validate_alpha_submission_by_id alpha_id="<id>"
{ "ready": false, "blocking": ["LOW_FITNESS"], "pending": ["SELF_CORRELATION"] }
The operator names above are part of BRAIN's public expression language; the pipeline never hard-codes proprietary data fields or alpha identifiers.
Implemented tools
healthcheckget_accountget_platform_operatorssearch_local_referenceget_reference_operatorsget_data_fieldsget_recent_alphasget_alphaget_alpha_submissioncreate_simulationbatch_simulatesummarize_alpha_batch_by_idmutate_alpha_expressionmap_research_hypothesisingest_research_materialget_simulationwait_simulationanalyze_alpha_noveltylog_alpha_experimentlist_alpha_experimentsvalidate_alpha_submission_by_idsubmit_alpha_by_id
Research Notes
docs/mcp-roadmap.mdtracks pragmatic MCP upgrades for alpha research.docs/quant-journey.mdis a running experiment log for future agents.src/worldquant_mcp/data/experiment_memory.jsonstores the same experiments in machine-readable form.