# karanvora2599/standard-tools architecture

> Architecture diagram of the GitHub repository karanvora2599/standard-tools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/karanvora2599/standard-tools
- Repository: https://github.com/karanvora2599/standard-tools

## Overview

Standard Quant Tools is a quantitative-finance library with an agent-facing tool surface. Its principal workflow is an agent request entering a scoped runtime, invoking quant/data/model/backtest capabilities, and returning structured results. The README documents research, data, modeling, portfolio, derivatives, delta-one, microstructure, backtesting, and audit capabilities; the graph preserves these alongside MCP serving. Source excerpts show runtime dispatch and modeling execution, but many domain implementations were not sampled, so their internal links are omitted rather than inferred.

Main entry points: [`src/standard_quant_tools/agent/runtimes/__init__.py`](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/agent/runtimes/__init__.py) (Scoped runtimes), [`src/standard_quant_tools/data`](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/data) (Market data), [`src/standard_quant_tools/modeling/engine.py`](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/modeling/engine.py) (Experiment engine), [`src/standard_quant_tools/analysis`](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/analysis) (Quant analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent["Agent interface"]
  node_mcp["MCP server<br/>[server.py]"]
  node_tool_catalog["Tool catalog<br/>[tools.py]"]
  node_runtimes["Scoped runtimes<br/>[__init__.py]"]
end

subgraph group_market["Market research"]
  node_analysis["Quant analysis"]
  node_indicators["Indicators"]
  node_metrics["Risk metrics<br/>[risk_metrics.py]"]
  node_screener["Stock screener<br/>[screener.py]"]
  node_microstructure["Market microstructure<br/>[microstructure.py]"]
end

subgraph group_model["Model lifecycle"]
  node_model_dataset["Dataset building"]
  node_preprocessing["Preprocessing<br/>[pipeline.py]"]
  node_model_engine["Experiment engine<br/>[engine.py]"]
  node_model_validation["Model validation"]
  node_model_registry[("Model registry")]
end

subgraph group_trading["Trading simulation"]
  node_backtest["Strategy backtests<br/>[engine.py]"]
  node_portfolio_backtest["Portfolio simulation"]
  node_portfolio["Portfolio analysis"]
  node_derivatives["Derivatives<br/>[derivatives.py]"]
  node_delta_one["Delta-one tools"]
end

subgraph group_platform["Data and audit"]
  node_data["Market data"]
  node_audit[("Decision audit")]
end

node_user(("Agent client"))
node_external_data["Data providers"]

node_user -->|"requests tools"| node_mcp
node_mcp -->|"dispatches calls"| node_runtimes
node_mcp -->|"selects tools"| node_tool_catalog
node_tool_catalog -->|"combines runtimes"| node_runtimes
node_runtimes -.->|"offers data tools"| node_data
node_runtimes -.->|"offers research tools"| node_analysis
node_runtimes -.->|"offers backtest tools"| node_backtest
node_runtimes -.->|"offers modeling tools"| node_model_engine
node_external_data -.->|"provides market data"| node_data
node_data -.->|"supplies inputs"| node_model_dataset
node_model_dataset -.->|"feeds experiments"| node_model_engine
node_model_engine -->|"fits transforms"| node_preprocessing
node_preprocessing -->|"returns transformed data"| node_model_engine
node_model_engine -->|"evaluates models"| node_model_validation
node_model_engine -->|"registers model"| node_model_registry
node_data -.->|"supplies observations"| node_analysis
node_analysis -.->|"uses indicators"| node_indicators
node_analysis -->|"computes risk"| node_metrics
node_data -.->|"screens securities"| node_screener
node_data -.->|"feeds market studies"| node_microstructure
node_analysis -.->|"informs strategies"| node_backtest
node_backtest -.->|"supports portfolio simulation"| node_portfolio_backtest
node_portfolio -.->|"provides portfolio methods"| node_portfolio_backtest
node_derivatives -.->|"exposed as tools"| node_runtimes
node_delta_one -.->|"exposed as tools"| node_runtimes
node_runtimes -.->|"records decisions"| node_audit

click node_mcp "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/mcp/server.py"
click node_tool_catalog "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/agent/tools.py"
click node_runtimes "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/agent/runtimes/__init__.py"
click node_data "https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/data"
click node_analysis "https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/analysis"
click node_indicators "https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/indicators"
click node_metrics "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/metrics/risk_metrics.py"
click node_screener "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/screener/screener.py"
click node_microstructure "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/analysis/microstructure.py"
click node_model_dataset "https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/modeling/dataset"
click node_preprocessing "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/modeling/preprocessing/pipeline.py"
click node_model_engine "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/modeling/engine.py"
click node_model_validation "https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/modeling/validation"
click node_model_registry "https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/modeling/registry"
click node_backtest "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/backtest/engine.py"
click node_portfolio_backtest "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/backtest/portfolio_engine.py"
click node_portfolio "https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/portfolio"
click node_derivatives "https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/analysis/derivatives.py"
click node_delta_one "https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/delta_one"
click node_audit "https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/audit"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp,node_tool_catalog,node_runtimes,node_user toneBlue
class node_analysis,node_indicators,node_metrics,node_screener,node_microstructure toneAmber
class node_model_dataset,node_preprocessing,node_model_engine,node_model_validation,node_model_registry toneMint
class node_backtest,node_portfolio_backtest,node_portfolio,node_derivatives,node_delta_one toneRose
class node_data,node_audit,node_external_data toneIndigo
```

## Components

### Agent interface

- [MCP server](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/mcp/server.py): `src/standard_quant_tools/mcp/server.py`
- [Tool catalog](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/agent/tools.py): `src/standard_quant_tools/agent/tools.py`
- [Scoped runtimes](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/agent/runtimes/__init__.py): `src/standard_quant_tools/agent/runtimes/__init__.py`

### Market research

- [Quant analysis](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/analysis): `src/standard_quant_tools/analysis`
- [Indicators](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/indicators): `src/standard_quant_tools/indicators`
- [Risk metrics](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/metrics/risk_metrics.py): `src/standard_quant_tools/metrics/risk_metrics.py`
- [Stock screener](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/screener/screener.py): `src/standard_quant_tools/screener/screener.py`
- [Market microstructure](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/analysis/microstructure.py): `src/standard_quant_tools/analysis/microstructure.py`

### Model lifecycle

- [Dataset building](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/modeling/dataset): `src/standard_quant_tools/modeling/dataset`
- [Preprocessing](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/modeling/preprocessing/pipeline.py): `src/standard_quant_tools/modeling/preprocessing/pipeline.py`
- [Experiment engine](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/modeling/engine.py): `src/standard_quant_tools/modeling/engine.py`
- [Model validation](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/modeling/validation): `src/standard_quant_tools/modeling/validation`
- [Model registry](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/modeling/registry): `src/standard_quant_tools/modeling/registry`

### Trading simulation

- [Strategy backtests](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/backtest/engine.py): `src/standard_quant_tools/backtest/engine.py`
- [Portfolio simulation](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/backtest/portfolio_engine.py): `src/standard_quant_tools/backtest/portfolio_engine.py`
- [Portfolio analysis](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/portfolio): `src/standard_quant_tools/portfolio`
- [Derivatives](https://github.com/karanvora2599/standard-tools/blob/main/src/standard_quant_tools/analysis/derivatives.py): `src/standard_quant_tools/analysis/derivatives.py`
- [Delta-one tools](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/delta_one): `src/standard_quant_tools/delta_one`

### Data and audit

- [Market data](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/data): `src/standard_quant_tools/data`
- [Decision audit](https://github.com/karanvora2599/standard-tools/tree/main/src/standard_quant_tools/audit): `src/standard_quant_tools/audit`

### Other components

- **Agent client**
- **Data providers**

## Connections

- Agent client → MCP server: requests tools (evidence: `src/standard_quant_tools/mcp/server.py`)
- MCP server → Scoped runtimes: dispatches calls (evidence: `src/standard_quant_tools/mcp/server.py`)
- MCP server → Tool catalog: selects tools (evidence: `src/standard_quant_tools/mcp/server.py`)
- Tool catalog → Scoped runtimes: combines runtimes (evidence: `src/standard_quant_tools/agent/tools.py`)
- Scoped runtimes → Market data: offers data tools (evidence: `src/standard_quant_tools/agent/runtimes/__init__.py`)
- Scoped runtimes → Quant analysis: offers research tools (evidence: `src/standard_quant_tools/agent/runtimes/__init__.py`)
- Scoped runtimes → Strategy backtests: offers backtest tools (evidence: `src/standard_quant_tools/agent/runtimes/__init__.py`)
- Scoped runtimes → Experiment engine: offers modeling tools (evidence: `src/standard_quant_tools/agent/runtimes/__init__.py`)
- Data providers → Market data: provides market data (evidence: `README.md`)
- Market data → Dataset building: supplies inputs (evidence: `README.md`)
- Dataset building → Experiment engine: feeds experiments (evidence: `src/standard_quant_tools/modeling/engine.py`)
- Experiment engine → Preprocessing: fits transforms (evidence: `src/standard_quant_tools/modeling/engine.py`)
- Preprocessing → Experiment engine: returns transformed data (evidence: `src/standard_quant_tools/modeling/preprocessing/pipeline.py`)
- Experiment engine → Model validation: evaluates models (evidence: `src/standard_quant_tools/modeling/engine.py`)
- Experiment engine → Model registry: registers model (evidence: `src/standard_quant_tools/modeling/engine.py`)
- Market data → Quant analysis: supplies observations (evidence: `README.md`)
- Quant analysis → Indicators: uses indicators (evidence: `README.md`)
- Quant analysis → Risk metrics: computes risk (evidence: `src/standard_quant_tools/metrics/risk_metrics.py`)
- Market data → Stock screener: screens securities (evidence: `README.md`)
- Market data → Market microstructure: feeds market studies (evidence: `README.md`)
- Quant analysis → Strategy backtests: informs strategies (evidence: `README.md`)
- Strategy backtests → Portfolio simulation: supports portfolio simulation (evidence: `README.md`)
- Portfolio analysis → Portfolio simulation: provides portfolio methods (evidence: `README.md`)
- Derivatives → Scoped runtimes: exposed as tools (evidence: `README.md`)
- Delta-one tools → Scoped runtimes: exposed as tools (evidence: `README.md`)
- Scoped runtimes → Decision audit: records decisions (evidence: `src/standard_quant_tools/agent/runtimes/__init__.py`)
