Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Howrisky

FreeNot checked

Official Model Context Protocol (MCP) server for AI-powered financial risk analysis. Monte Carlo simulations with fat-tail modeling (CVaR, VaR, ruin probability

GitHubEmbed

About

Official Model Context Protocol (MCP) server for AI-powered financial risk analysis. Monte Carlo simulations with fat-tail modeling (CVaR, VaR, ruin probability) for Claude Desktop, Cursor, Windsurf, Cline, Copilot. 8 tools: portfolio risk, startup equity, real estate, Kelly criterion betting. Proprietary KDE algorithm.

README

Monte Carlo risk analysis for AI agents. Institutional-grade financial modeling with fat-tail distributions and proprietary KDE algorithms.

8 Tools: Portfolio risk (CVaR, ruin probability), startup equity, real estate, Kelly criterion betting, and more.

Compatible with: Claude Desktop, ChatGPT Desktop, Cursor, Windsurf, Cline, GitHub Copilot, VS Code, Codex


Standard Config

{
  "mcpServers": {
    "howrisky": {
      "command": "npx",
      "args": ["-y", "howrisky-mcp-server"],
      "env": {
        "HOWRISKY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Get your free API key at: https://howrisky.ai/app/settings (100 calls/month free)


Getting Started

Step 1: Get your API key from https://howrisky.ai/app/settings

Step 2: Add the standard config above to your AI tool's MCP configuration

That's it! Your AI can now access Monte Carlo risk simulations.


Installation

Claude Desktop

Edit config file:

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the standard config above.

Restart Claude Desktop.

Test it: Ask Claude "Using HowRisky, what's the risk of a 60/40 portfolio?"

ChatGPT Desktop
  1. Open ChatGPT Desktop Settings
  2. Go to Apps & ConnectorsAdvanced settings
  3. Enable Developer mode
  4. Add MCP server configuration (use standard config above)

Restart ChatGPT Desktop.

Test it: Ask ChatGPT "Use HowRisky to calculate CVaR for 100% SPY portfolio"

Cursor

Add to Cursor's MCP configuration file:

Use the standard config above.

Cursor supports MCP via VS Code extension compatibility.

Windsurf

Add to Windsurf MCP settings:

Use the standard config above.

Windsurf's MCP integration works similarly to Cursor.

Cline (VS Code)

Via Cline MCP Marketplace:

  1. Open Cline in VS Code
  2. Search for "howrisky" in MCP Marketplace
  3. Click Install
  4. Enter API key when prompted

Manual Setup:

Add to VS Code Settings → Extensions → Cline → MCP Servers:

Use the standard config above.

GitHub Copilot / VS Code

Add to VS Code settings.json:

Use the standard config above in the MCP servers configuration section.

Remote Server (HTTP)

For custom integrations or web-based AI tools:

Endpoint: https://mcp.howrisky.ai

Authentication: Include X-API-Key header with your API key

Documentation: https://howrisky.ai/mcp/docs

Example:

curl -X POST https://mcp.howrisky.ai \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Available Tools

Tool Description
calculate_portfolio_risk CVaR, VaR, ruin probability, survival probability
simulate_future_timelines Year-by-year portfolio evolution with percentiles
compare_portfolios Side-by-side risk comparison of multiple portfolios
text_to_portfolio Natural language → asset allocations
add_startup Startup equity modeling with exit scenarios
add_real_estate Real estate with cash flows, IRR, mortgage analysis
add_private_asset Illiquid asset modeling (PE funds, etc.)
add_gamble Kelly criterion for high-risk betting strategies

Full documentation: https://howrisky.ai/mcp/docs


Example Usage

Once configured, ask your AI:

"Using HowRisky, calculate the risk of investing $100K in a 60/40 portfolio over 20 years"

The AI will:

  1. Discover HowRisky tools via tools/list
  2. Call calculate_portfolio_risk with correct parameters
  3. Return CVaR, survival probability, ruin risk, and other metrics

Features

Fat-Tail Modeling - Gaussian models underestimate crash risk by 3-10x. Our proprietary KDE captures reality.

Comprehensive Metrics - 12 risk metrics including CVaR 95/99, VaR, ruin probability, percentiles

Private Assets - Model startups, real estate, PE funds, and high-risk gambles

Tax-Aware - 15+ countries supported (US, GB, DE, FR, IT, ES, JP, AU, CA, etc.)

Custom Scenarios - Override historical data with your own market assumptions


Pricing

Tier Calls/Month Price
Free 100 $0
Developer 10,000 $99
Professional 100,000 $299
Enterprise 1,000,000 $999

View pricing: https://howrisky.ai/mcp/pricing


Support


License

Proprietary - Copyright © 2025 Diogo Seca / HowRisky.ai

You may use this software to access HowRisky MCP API. Modification and redistribution prohibited. See LICENSE for details.

from github.com/howrisky/howrisky-mcp-server

Installing Howrisky

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/howrisky/howrisky-mcp-server

FAQ

Is Howrisky MCP free?

Yes, Howrisky MCP is free — one-click install via Unyly at no cost.

Does Howrisky need an API key?

No, Howrisky runs without API keys or environment variables.

Is Howrisky hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Howrisky in Claude Desktop, Claude Code or Cursor?

Open Howrisky on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Howrisky with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs