Skip to content
MCP server

Folionomiq

Measure a portfolio from price history: separate bets, fund look-through and past crises

Install
Pricing
Free
Platforms
Web, API
Runs
Remotely
Version
1.6.1
Listing updated
3 days ago

About Folionomiq

Folionomiq is a free MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

Folionomiq gives ChatGPT or Claude figures they cannot produce alone, because assistants lack price history. Ask about a mix like 60% VTI, 20% VXUS and 20% BND, and the server returns how many independent bets it really holds, which fund carries most of the risk, which companies you own through your funds, and what 2008 or 2020 would have done to a stated amount, including the worst day and time to recover.

It also tests changes before you make them (adding SCHD to VOO, say), replays yearly withdrawals against real history from every possible start month, and compares up to eight portfolios over one window. Tickers, fund names or ISINs work, as amounts, percentages or share counts.

Every answer is descriptive and based on end-of-day prices over a stated window. It does not forecast and does not say what to buy, sell or hold. Fund holdings come from what funds publish, usually the largest positions, so look-through company figures are minimums and the answer says how much of the money they cover. The site describes itself as a non-commercial project that needs no account and stores nothing.

Install

Run in a terminal

claude mcp add --transport http folionomiq https://folionomiq.com/mcp

Add to Settings → Connectors → Add custom connector

https://folionomiq.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "folionomiq": {
      "url": "https://folionomiq.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "folionomiq": {
      "type": "http",
      "url": "https://folionomiq.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "folionomiq": {
      "serverUrl": "https://folionomiq.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "folionomiq": {
      "type": "http",
      "url": "https://folionomiq.com/mcp"
    }
  }
}

Tools this server provides (22)

Taken from the project documentation; the running server may differ.

measure_portfolio
Measures separate bets, risk concentration, fund look-through and past crises.
compare_portfolios
Measures up to eight portfolios over one shared window.
test_a_change
Measures a portfolio now and after a proposed change on the same history.
check_before_you_buy
Measures one addition against the portfolio it would join.
living_off_it
Replays yearly withdrawals on the portfolio's history.
portfolio_structure
Shows separate bets and who carries the risk.
look_through
Shows companies held under the funds.
past_crises
Replays past crises on the portfolio.
portfolio_report
Returns the numbered report.
factor_exposure
Shows sensitivity to market, size, value and momentum.
currency_effect
Shows what exchange rates did to the money.
health_axes
Reads the portfolio along separate axes.
sweep_holding
Shows one holding at every weight.
reverse_stress
Shows market moves a given loss would take.
return_history
Shows the record month by month.
plain_findings
Gives a few findings in plain words.
last_price
Returns a latest close.
asset_info
Returns a fund or share's cost and holdings.
monthly_plan
Replays buying the same amount monthly.
walk_forward
Tests an allocation method on unseen prices.
search_symbols
Finds a ticker by name or ISIN.
validate_symbols
Checks which symbols have usable history.

What it does

Independent bets
Counts how many separate bets a portfolio holds and which holding carries the risk.
Fund look-through
Adds up companies owned through several funds and states how much money that view covers.
Crisis replay
Shows the fall in money, worst day and recovery time for past crises.
Change testing
Measures a portfolio before and after a proposed addition, without recommending it.
Withdrawal replay
Replays yearly withdrawals from every start month on real history.
Symbol search
Finds tickers by name or ISIN and checks for usable history.

Good for

  • Check whether a three-fund portfolio is really diversified
  • See which companies sit under overlapping funds
  • Estimate what past crises would have done to a given amount
  • Test whether adding a fund adds a new bet

Pricing

Free

Free, no account; non-commercial project

Prices change. Check folionomiq.com before you buy.

Folionomiq FAQ

Do I need an account?

No. The site says there is no login and no key, and nothing is stored.

Does it give investment advice?

No. Answers are descriptive and it says whether to buy, sell or hold is not part of it.

Why are look-through holdings minimums?

Funds usually publish their largest positions only, and each answer states how much of the money is covered.

How many tools does it expose?

22, including measure_portfolio, compare_portfolios, test_a_change and living_off_it.

Is Folionomiq free?

Yes. Folionomiq is free to use.

How do I add Folionomiq to Claude Code?

Run this command in your terminal: claude mcp add --transport http folionomiq https://folionomiq.com/mcp

What are the best alternatives to Folionomiq?

The closest alternatives to Folionomiq are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Folionomiq

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government