RiskModels

Name: RiskModels
Author: BlueWaterCorp

by BlueWaterCorpversion 2.0.1i★ 0iComputer or cloud

Registry nameio.github.BlueWaterCorp/riskmodels

How to install

What it does

Dividend-adjusted US equity total returns, risk decomposition, attribution & ETF hedge ratios

Connects Computer or cloud
Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: No key needed
Category Other

Install

Pick the AI app you use, then copy the settings.

Passed 5/5 checks · What you ask goes through the maker’s server (riskmodels.app)

First: which AI do you use?

ClaudeWeb · app · phoneChatGPTWebClaude CodeTerminalCursorCode editorVS CodeCode editorOtherOther apps

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

Open Claude’s Connectors page
CustomizeConnectors
Done
Click “+ Add” → “Add custom connector” and fill in these 2 fields
Copy each value into the field with the same name in Claude, then click Continue
Name · NameRiskModels
Remote MCP server URL · Addresshttps://riskmodels.app/api/mcp/sse
Leave Authentication as Claude detected it, then click Add
Done
Turn it on in a chat
+ConnectorsRiskModels
Done
Try it
Use RiskModels and tell me what you can do for me, then show me one thing
✓ If Claude says it is using RiskModels or shows a RiskModels tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT on business plans only

ChatGPT Business, Enterprise or Edu on the web, added by a workspace admin or owner · On Free, Plus or Pro: your ChatGPT plan cannot connect MCP yet

Open ChatGPT’s add-MCP page on the web
Plugins+Add custom MCP server
Done
Fill in the name and address
Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin
Name · NameRiskModels
Connection · Addresshttps://riskmodels.app/api/mcp/sse
Done
Pick RiskModels in a chat
Start a new chat and pick RiskModels from your plugins before typing
Done
Try it
Use RiskModels and tell me what you can do for me, then show me one thing
✓ If ChatGPT says it is using RiskModels or shows a RiskModels tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Done

Paste this command and press Enter

claude mcp add --transport http --scope user riskmodels https://riskmodels.app/api/mcp/sse

Done

Type /mcp in Claude Code
You should see RiskModels listed as connected
Done
Try it
Use RiskModels and tell me what you can do for me, then show me one thing
✓ If Claude Code says it is using RiskModels or shows a RiskModels tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

Click this button to open Cursor
Open in Cursor
Cursor asks you to confirm; click Install
Done
Open the AI chat in Cursor in Agent mode
Done
Try it
Use RiskModels and tell me what you can do for me, then show me one thing
✓ If Cursor says it is using RiskModels or shows a RiskModels tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

Click this button to open VS Code
Open in VS Code
VS Code asks you to confirm; click Install
Done
Open the AI chat in VS Code in Agent mode
Done
Try it
Use RiskModels and tell me what you can do for me, then show me one thing
✓ If VS Code says it is using RiskModels or shows a RiskModels tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://riskmodels.app/api/mcp/sse

JSON settings are under “For developers” below

Stuck? Ask people who use RiskModels💬 Discussion →

For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user riskmodels https://riskmodels.app/api/mcp/sse

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "riskmodels": {
      "url": "https://riskmodels.app/api/mcp/sse"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "riskmodels": {
      "type": "http",
      "url": "https://riskmodels.app/api/mcp/sse"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user riskmodels -- npx -y @riskmodels/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "riskmodels": {
      "command": "npx",
      "args": [
        "-y",
        "@riskmodels/mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "riskmodels": {
      "command": "npx",
      "args": [
        "-y",
        "@riskmodels/mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "riskmodels": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@riskmodels/mcp"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub stars i: 0
Downloads per weeki: 119/wk
Licence i: Apache-2.0
Connection: Computer or cloud
Transport: stdio, streamable-http
Latest versioni: 2.0.1
Categoryi: Other
Published to registryi: Oct 16, 2026
Code last changedi: Nov 11, 2026
Maker: BlueWaterCorp
Packages: npm: @riskmodels/mcp
Repo: BlueWaterCorp/RiskModels_API
Website: riskmodels.app
Registry status: Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

Claude ChatGPT Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Open WebUI Raycast

Run on your computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

All apps, with pros and cons →

What it can do

The server asks you to sign in before it lists its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 13, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account BlueWaterCorp, which owns the repo
✓ Pass
Still maintained
Code last changed 2 days ago
✓ Pass
Has a licence
Uses Apache-2.0
✓ Pass
Endpoint responds
Responded in 388 ms (HTTP 401)
✓ Pass
Sign-in with OAuth
Declares OAuth sign-in, so your AI app can take you to log in
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

User reviews

No reviews yet

Compared with others in Otheri

More stars than 0% of the other 19416 servers in this category
Published to the registry more recently than 61% of the other 19416 servers in this category
Basic checks equal to or better than 100% of the other 19416 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is RiskModels safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 2 days ago, and the latest version (2.0.1) reached the registry 28 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT Business and above.

What can I use instead?

In the same category: World Monitor, Claude Flow, Windmill

Others in the same category

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 104 tools.

by koala73Widely used★ 90.5KUpdated yesterday

Runs in the cloud✓ service owner · worldmonitor.app

Install

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

by ruvnetWidely used↓ 13.5K/wk★ 81.5KUpdated 14 months ago

Runs on your computer

Install

Windmill

Run Windmill scripts and flows and manage jobs, schedules, resources and variables.

by windmill-labsWidely used★ 18.6KUpdated yesterday

Runs in the cloud

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

RiskModels provides clean dividend-adjusted total returns, factor risk decomposition, return attribution, and ETF-executable hedge ratios for US equities — over REST, a typed SDK, and a built-in MCP server. The dataset is simulation-grade: it covers on the order of 16,000 US stocks across the full historical panel, while at each month end the model’s headline universe is the largest ~3,000 by market cap—the set the API surfaces for everyday returns, risk, and hedging.

Post-regression outputs (hedge ratios, explained-risk decompositions, and related L1–L3 series) are served from the first date whose full estimation window is covered: hedge ratios from 2010-12-08, explained-risk shares and stock variance from 2011-12-07, **L\* residual levels from 2013-01-01. Split- and dividend-adjusted returns (the inputs to the rolling regressions) begin 2006-01-04**. The API is AI-agent ready, including a built-in Model Context Protocol (MCP) server for seamless integration with LLMs.

RiskModels API Developer Portal

This repository is the authoritative public API reference for the RiskModels equity risk model API, featuring:

📖 Model methodology — ERM3 overview (canonical; also mirrored on riskmodels.net)
📚 Comprehensive API Documentation — OpenAPI 3.0.3 specification, guides, and examples
🌐 Developer Portal — Beautiful Next.js site (this repo) deployed at riskmodels.app
🐍 Python & TypeScript Examples — Production-ready code in examples/
🤖 AI Agent Integration — MCP server, OAuth2, and agent manifest

Use in Cursor (Agent Plugin)

This repository is an Agent Plugins package: plugin.json and mcp.json at the repository root. The plugin connects Cursor to the hosted RiskModels MCP server. It contains no code that runs on your machine and no credentials.

File	What it declares
`plugin.json`	Plugin `riskmodels` 1.0.0, Apache-2.0
`mcp.json`	One server, `riskmodels`: Streamable HTTP at `https://riskmodels.app/api/mcp/openai`

Install

In Cursor, open the Marketplace and search for RiskModels.
Install it for your user or for the current project.
Cursor adds the riskmodels MCP server. Its tools appear once you sign in.

Sign in

The server uses OAuth 2.1 with PKCE. Cursor handles the flow, and nothing goes in the plugin files:

When Cursor first connects to the riskmodels server, the server asks for sign-in and Cursor opens a browser at riskmodels.app.
Sign in with Google or an email link, or choose Sign in with a password instead.
The consent screen shows Signed in as <email>. If that is the wrong account, click Use a different account first, then Allow.
Cursor stores the token. The tools are read-only: they return data and never place orders or change your account.

Pricing and account

A RiskModels account is required. New accounts start with $20 of prepaid credit. A payment method is collected at signup for verification and is not charged until you top up.
Usage is pay-as-you-go and billed per tool call against that balance. Most single-stock calls cost $0.005; fundamentals cost $0.02, and a full portfolio exposure report costs $0.25. Rates and plans: riskmodels.app/pricing.
Optional: link a brokerage account (Alpaca, Connect Trade or Plaid) in riskmodels.net Settings, and riskmodels_get_my_positions reads that book.

Example: NVDA

Ask in Cursor's agent chat:

Decompose NVDA's risk with RiskModels and give me the ETF hedge for a $100,000 position.

The agent calls riskmodels_decompose for the market / sector / subsector / stock-specific split of NVDA's variance and the hedge ratio at each level. Then it calls riskmodels_decompose again with a dollar amount to turn those ratios into dollar trades in SPY and the sector and subsector ETFs. The numbers are live model output as of the latest trading day.

The Claude plugin (claude-plugin/) and the local developer MCP server (.cursor/mcp.json, mcp/) are separate and unchanged.

🚀 Quick Links

Python SDK — AOM quickstart (Google Colab): Open notebook · source: sdk/notebooks/riskmodels_aom_colab.ipynb
Developer Portal: riskmodels.app
Live API Docs: riskmodels.net/docs/api/erm3
ERM3 methodology: riskmodels.app/docs/methodology
Get API Key: riskmodels.app/get-key
API Terms: riskmodels.net/terms/api
Issues: github.com/BlueWaterCorp/RiskModels_API/issues
PyPI (Python SDK): riskmodels-py

Canonical URLs (REST, OpenAPI, and docs)

Use these only for integrations and tooling:

What	URL
REST base (OpenAPI `servers`)	`https://riskmodels.app/api`
Deployed OpenAPI JSON (same spec as `OPENAPI_SPEC.yaml`)	`https://riskmodels.app/openapi.json`
Interactive API reference (this portal)	`/api-reference`

Important: The hostname `api.riskmodels.app` is not used for the public API or machine-readable docs. Older links or docs that mention it should be treated as obsolete; use `riskmodels.app` (apex) as above.

📖 API Overview

The RiskModels API provides institutional-grade equity risk analysis:

Daily factor decompositions — market, sector, subsector explained-risk fractions for the headline ~3,000 largest US stocks by market cap (month-end universe)
Hedge ratios — dollar-denominated ETF hedge amounts (L1/L2/L3) designed to remain executable with liquid raw ETFs
Historical time series — split- and dividend-adjusted returns (2006-01-04–present) plus rolling hedge ratios (2010-12-08–present) and ER (2011-12-07–present; factor outputs need a full regression window)
AI-agent ready — OAuth2, per-request billing, machine-readable manifests

Data coverage: ~16,000 US stocks in the historical panel; ~3,000 largest by market cap at each month end for headline outputs. Updated daily. Hedge ratios: 2010-12-08 through present. Explained risk: 2011-12-07 through present. **L\* levels: 2013-01-01 through present. Adjusted return series: 2006-01-04** through present.

Why The Engine Matters

RiskModels is designed to be useful for real portfolio work, not just descriptive analytics:

Built to be time-safe — the engine is designed to avoid common sources of forward contamination such as recycled tickers, snapshot shares, and retroactive universe contraction
Grounded in a real Security Master — ticker-level outputs sit on top of a point-in-time identity layer built for identifier continuity, symbol changes, and historically defensible shares data
Hierarchical by design — the model separates market, sector, and subsector structure rather than collapsing everything into a flat beta view
Tradeable in practice — the published hedge ratios are designed to work with liquid ETFs at execution time, not only with synthetic or orthogonalized factors
Built on adjusted return series — split- and dividend-adjusted returns make the decomposition and hedge ratios more economically consistent over long horizons

For a deeper explanation of the engine design choices behind these claims, see the methodology docs and API reference.

🐍 Python SDK (riskmodels-py)

Prefer the Python SDK over raw REST for agent-native workflows — ticker resolution, semantic field normalization, validation with instructional errors, and LLM-ready context formatting are built in.

Install (PyPI):

pip install riskmodels-py

Optional — xarray cube from batch Parquet/CSV:

pip install riskmodels-py[xarray]

Optional — snapshot PDF rendering:

pip install riskmodels-py[pdf]

Quickstart:

from riskmodels import RiskModelsClient, to_llm_context

client = RiskModelsClient.from_env() pa = client.analyze({"NVDA": 0.4, "AAPL": 0.6}) print(to_llm_context(pa))

Snapshot generation (institutional PDF reports):

from riskmodels.snapshots import get_data_for_r1, render_r1_to_pdf

client = RiskModelsClient.from_env() data = get_data_for_r1("NVDA", client) # fetch → R1Data (caches to JSON) render_r1_to_pdf(data, "NVDA_R1_Risk.pdf") # render → PDF (~0.3s, no API)

Documentation:

Package README — install, methods, agent-native helpers
Quickstart — 60-second setup path
API Docs — agent-native helpers reference table

Risk intelligence

Charts below are generated from live API data (get_rankings + MAG7 L3 batch metrics) via scripts/generate_readme_assets.py. Set RISKMODELS_API_KEY (free tier is sufficient), run the script from the repo root, then commit ./assets/ and ./public/docs/readme/.

MAG7 — L3 σ-scaled decomposition

Same “tech” label, different subsector DNA — bar length ∝ annualized σ; segments = σ × L3 market/sector/subsector risk ratios + residual (HR share). POST /batch/analyze via SDK save_mag7_l3_sigma_rr_png

Cross-sectional rankings

Universe / sector / subsector rank percentile breakdown

🤖 MCP Server (v3.0.0-agent)

RiskModels includes a first-class MCP (Model Context Protocol) server, enabling AI agents to directly query risk data and perform factor analysis.

MCP Connection (hosted API):

Endpoint (Streamable HTTP, POST): https://riskmodels.app/api/mcp
Named endpoints: /api/mcp/openai and /api/mcp/sse remain supported
Authentication: Bearer token (API key or OAuth2 JWT)
Discovery: https://riskmodels.app/.well-known/mcp.json (see OPENAPI_SPEC.yaml)

Local MCP server (`mcp/` in this repo, `@riskmodels/mcp` 2.0.0) — stdio transport for Cursor / Claude Desktop / Zed. Tool set 2.0 is one registry shared with the hosted endpoints: 25 tools locally, 26 hosted (adds riskmodels_render_artifact):

riskmodels_get_stock_snapshot, riskmodels_decompose, riskmodels_compare, riskmodels_get_returns, `ris

Only the beginning is shown; read the rest in the repo

RiskModels

What it does

Install

Open Claude’s Connectors page

Click “+ Add” → “Add custom connector” and fill in these 2 fields

Turn it on in a chat

Try it

Open ChatGPT’s add-MCP page on the web

Fill in the name and address

Pick RiskModels in a chat

Try it

Open Terminal

Paste this command and press Enter

Type /mcp in Claude Code

Try it

Click this button to open Cursor

Open the AI chat in Cursor in Agent mode

Try it

Click this button to open VS Code

Open the AI chat in VS Code in Agent mode

Try it

Over the web

Installed on your computer

At a glance

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Discussion

User reviews

Compared with others in Otheri

Common questions

Others in the same category

World Monitor

Claude Flow

Windmill

README from the maker

RiskModels API Developer Portal

Use in Cursor (Agent Plugin)

Install

Sign in

Pricing and account

Example: NVDA

🚀 Quick Links

Canonical URLs (REST, OpenAPI, and docs)

📖 API Overview

Why The Engine Matters

🐍 Python SDK (riskmodels-py)

Optional — xarray cube from batch Parquet/CSV:

pip install riskmodels-py[xarray]

Optional — snapshot PDF rendering:

pip install riskmodels-py[pdf]

Risk intelligence

MAG7 — L3 σ-scaled decomposition

Cross-sectional rankings

🤖 MCP Server (v3.0.0-agent)