{
  "markdown": "<p align=\"center\">\n  <a href=\"https://helveticresearch.com\">\n    <img src=\"https://helveticresearch.com/static/brand/helvetic-icon-192.png\" alt=\"Helvetic Research\" width=\"104\" />\n  </a>\n</p>\n\n<h1 align=\"center\">Helvetic Research</h1>\n\n<p align=\"center\">\n  <strong>Institutional research. Conversational speed.</strong><br />\n  A research-only quantitative engine for Claude, ChatGPT, Codex, Cursor, and other MCP clients.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://helveticresearch.com\">Website</a> ·\n  <a href=\"https://helveticresearch.com/sample\">Live sample</a> ·\n  <a href=\"https://helveticresearch.com/methodology\">Methodology</a> ·\n  <a href=\"https://helveticresearch.com/connect\">Connect</a>\n</p>\n\n<p align=\"center\">\n  <img alt=\"Research only\" src=\"https://img.shields.io/badge/scope-research%20only-07162f\" />\n  <img alt=\"Model Context Protocol\" src=\"https://img.shields.io/badge/protocol-MCP-d7ae60\" />\n  <img alt=\"85 research tools\" src=\"https://img.shields.io/badge/tools-85-07162f\" />\n  <img alt=\"No trade execution\" src=\"https://img.shields.io/badge/trading-no%20execution-6b7280\" />\n</p>\n\n---\n\nHelvetic Research turns the AI interface you already use into a quantitative research desk.\nDescribe a strategy, portfolio, signal, or track record; your AI translates the request into a\nvalidated specification and calls a deterministic research engine. The result comes back with\nmetrics, robustness diagnostics, provenance, integrity checks, and reproducibility metadata.\n\nThe hosted service exposes **85 MCP research tools**. It does **not** place trades, connect to\nbrokers, or provide investment advice.\n\n## Why it exists\n\nAsking an AI to write and run a one-off backtest can produce plausible output without a stable\nmethod, consistent annualisation, realistic costs, or an audit trail. Helvetic separates the two\njobs:\n\n```mermaid\nflowchart LR\n    A[Research question] --> B[Your AI interface]\n    B --> C[Validated JSON strategy specification]\n    C --> D[Deterministic Helvetic engine]\n    D --> E[Research result]\n    E --> F[Metrics and charts]\n    E --> G[Robustness tests]\n    E --> H[Provenance and audit bundle]\n```\n\nThe AI handles conversation and tool selection. Helvetic handles calculation, validation,\nstorage, provenance, and reporting. Arbitrary client code is never executed inside the hosted\nweb/MCP process.\n\n## Research → Validate → Understand\n\n| Research | Validate | Understand |\n|---|---|---|\n| Backtest strategies, portfolios, signals, and external track records | Challenge results for overfitting, instability, costs, look-ahead risk, and regime dependence | Inspect performance drivers, drawdowns, trades, exposures, factors, tail risk, and assumptions |\n| Natural language, Pine-like logic, structured JSON, or supplied data | Walk-forward, Monte Carlo, CSCV/PBO, PSR/DSR, stress tests, sensitivity analysis | Interactive result pages, in-chat MCP Apps, PDF/Excel/CSV, and self-verifying audit bundles |\n\n## What you can research\n\n### Strategy inputs\n\n- Plain English or pseudo-code\n- Pine-like / TradingView strategy logic\n- Deterministic structured JSON\n- Strategy IR v3 typed JSON AST\n- Client-supplied OHLCV bars, including intraday data\n- Client-computed signal or position series\n- Multi-asset prices and target weights\n- An external return stream or fund track record\n\n### Markets and portfolio work\n\n- Equities, ETFs, indices through suitable tickers or ETF proxies, FX, commodities,\n  crypto, futures proxies, and macro/reference series\n- Single-instrument rules, long/short research, rotation, multi-asset portfolios,\n  synthetic options, universes, and custom supplied books\n- CHF, USD, EUR, and GBP reporting currencies\n- Monthly, quarterly, semi-annual, annual, and buy-and-hold portfolio rebalancing\n- Efficient-frontier, maximum-Sharpe, minimum-volatility, and risk-parity analysis\n\n### Signals and costs\n\n- 40+ indicator families with parameterised periods: moving averages, RSI, MACD,\n  Bollinger Bands, ATR, ADX, Ichimoku, Supertrend, volume profile, pivots, Fibonacci,\n  Heikin-Ashi, Aroon, Vortex, KST, and more\n- Nested AND/OR conditions, crosses, rolling levels, calendar rules, higher-timeframe\n  filters, stateful exits, trailing stops, position age, and sizing rules\n- Commissions, spreads, slippage, volatility-linked slippage, market impact, short borrow,\n  futures roll, crypto funding, FX conversion, management fees, custody fees, and TER\n\nSee the full, public [capability catalogue](CAPABILITIES.md).\n\n## Robustness and statistical diagnostics\n\nHelvetic is designed to challenge a result, not merely produce one:\n\n- Walk-forward out-of-sample analysis\n- Monte Carlo simulation with IID and block bootstrap\n- Parameter sweeps and cost/signal-lag sensitivity\n- Probability of Backtest Overfitting via CSCV\n- Probabilistic and Deflated Sharpe Ratio\n- Historical stress periods and custom scenarios\n- Volatility, trend, and macro regime analysis\n- Factor exposure, alpha decay, capacity, and implementation-cost analysis\n- EVT tail-risk analysis, VaR, and Expected Shortfall\n- A 12-component Research Grade measuring strength of evidence—not whether a strategy is\n  suitable to trade\n\n## Outputs and reproducibility\n\nEvery completed run records the information needed to understand what was actually tested:\n\n- Data provider and retrieval timestamp\n- Adjustment method and coverage information\n- Missing-data, stale-cache, and provider-disagreement warnings\n- SHA-256 dataset and strategy fingerprints\n- Engine version, assumptions, configured costs, and integrity checks\n- Frequency-correct performance and risk metrics\n\nResults can be viewed on the interactive web result page or inside supported AI chats through\nan MCP App. They can also be exported as branded PDF, Excel, CSV, JSON, or a self-verifying\naudit bundle containing raw series, formulas, hashes, assumptions, and provenance.\n\n## Connect an AI client\n\n1. Visit **[helveticresearch.com](https://helveticresearch.com)** and continue with Google.\n2. Open **[/connect](https://helveticresearch.com/connect)** for client-specific instructions.\n3. Add the hosted MCP endpoint and complete OAuth:\n\n   ```text\n   https://helveticresearch.com/mcp\n   ```\n\n4. Start with a complete research request, for example:\n\n   ```text\n   Backtest SPY from 2005-01-01 to 2026-01-01. Go long when price crosses\n   above its 200-day simple moving average and exit when it crosses below.\n   Apply 10 bps transaction costs, show the key metrics, then run a\n   walk-forward test and an overfitting check.\n   ```\n\nThe Free plan includes **250 research credits per month** and full available history from\ncommunity data sources. Heavy workflows use more credits than lightweight lookups.\n\n## Data coverage\n\n| Asset/data type | Primary path | Fallback/reference path |\n|---|---|---|\n| Equities and ETFs | Yahoo Finance | Tiingo EOD when configured |\n| Crypto | Yahoo Finance | Coinbase Exchange |\n| Macro and rates | FRED | ECB Data Portal where applicable |\n| FX | Yahoo Finance | ECB reference series where applicable |\n\nBuilt-in intraday retrieval uses Yahoo/yfinance and preserves full OHLCV timestamps. Practical\nprovider lookbacks are approximately 7 days for `1m`, 60 days for `2m`–`90m`, and 730 days for\n`1h` plus resampled `2h`/`3h`/`4h`. Tiingo and Coinbase fallbacks are daily-only. Longer or\nlicensed intraday histories can be supplied through custom OHLCV tools.\n\nCommunity data is useful for research and prototyping but is not a licensed point-in-time\ninstitutional feed. Historical constituents, delistings, symbol changes, corporate actions,\nfutures rolls, and survivorship controls can be incomplete. Read the full\n[data coverage and limitations](DATA_AND_LIMITATIONS.md).\n\n## Important boundaries\n\n- **Research only:** no orders, brokerage connections, or portfolio execution\n- **No investment advice:** outputs are analytical and educational\n- **Synthetic options:** Black-Scholes simulations, not historical option-chain fills\n- **No arbitrary code execution:** strategies run through supported deterministic schemas\n- **Private by default:** research records are account-scoped; publication is explicit\n- **Failures remain visible:** degraded data and unsupported requests return warnings or clear\n  errors rather than silent success\n\n## Public resources\n\n- [Explore a real sample result](https://helveticresearch.com/sample)\n- [Read the methodology](https://helveticresearch.com/methodology)\n- [Review security controls](https://helveticresearch.com/security)\n- [Read the research disclaimer](https://helveticresearch.com/research-disclaimer)\n- [Browse the website](https://helveticresearch.com)\n- Report vulnerabilities privately using [SECURITY.md](SECURITY.md)\n\n## About this repository\n\nThe production research engine is a hosted service and is not open source. This public repository\nprovides the canonical project overview, capability documentation, data limitations, security\npolicy, and registry metadata. An open-source verifier for exported Helvetic audit bundles is\nplanned for this repository.\n\nQuestions and product feedback: **[hello@helveticresearch.com](mailto:hello@helveticresearch.com)**\n\n---\n\n<p align=\"center\">\n  <a href=\"https://helveticresearch.com/privacy\">Privacy</a> ·\n  <a href=\"https://helveticresearch.com/terms\">Terms</a> ·\n  <a href=\"https://helveticresearch.com/legal-notice\">Legal notice</a> ·\n  <a href=\"https://helveticresearch.com/research-disclaimer\">Research disclaimer</a>\n</p>\n",
  "bytes": 9446,
  "sha": "b8d330a97abc99fca2297eea3ede8cc16a8eb4576448bb1d130dd2d0e98f5384",
  "repo_slug": "helvetic-research/helvetic-research",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kushpatil22_helvetic_research_e6316812/readme"
}