Wealthapi MCP server
eu.wealthapi/mcp-server·v0.1.0Read-only MCP server for wealthAPI: portfolio, cash-flow, and dividend insights for AI assistants.
0 stars33 downloads/wk
Reviews
Write oneNobody has reviewed Wealthapi yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Wealthapi tools (21)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
detect_recurring_transactionsList transactions flagged as regular (salary, rent, subscriptions, standing orders). Grouped by counterpart and direction, with detected payment interval (in months) and average amount. Use this to answer 'what subscriptions do I have?' or 'what are my fixed costs?'.
get_account_balancesGet balance history for one or more cash accounts over a date range. Works only with cash accounts (type '02_cash'), not depots.
get_cash_flow_summaryMonthly income vs. spending for the user's cash accounts. Answers 'how much did I earn and spend?' over a period. Inflows are positive, outflows positive (spending), net = income − spending.
get_dividend_calendarGet this year's dividend calendar for current holdings: expected and received payouts with dates, amounts and yields. Use this for 'when are my next dividend payments?'.
get_dividend_historyGet dividend income per year (gross and net), with a per-month breakdown for the current year. Use this for 'how much dividend income did I get in 2024?'.
get_gainers_and_losersGet the top gainers or losers — either by today's change or by total return since purchase. Use this for 'best/worst performers'.
get_portfolio_allocationBreak down the portfolio's market value by region, industry sector, or asset type. Use this for 'how diversified am I?' and 'what's my US exposure?'.
get_portfolio_performanceGet TWROR (time-weighted rate of return) timeseries for the portfolio over a date range. Use this to answer 'how did my portfolio perform this year / last 5 years?'.
get_portfolio_valuationGet the current total value of one or more depots, and optionally its history when 'from' is given. Use this for 'what is my portfolio worth (today / over time)?'.
get_portfolio_yieldGet the portfolio's dividend yield per year (on current value and on invested capital) plus the dividend CAGR. Use this for 'what's my dividend yield?'.
get_quotesGet current quotes (last price, daily change) for securities by security ID. Get the IDs from search_symbols first.
get_realized_gainsGet realized gains per year, split into trading, dividend, interest and other gains (gross and net, plus tax refunds). Use this for 'what did I realize this year?' and tax questions.
get_risk_metricsGet annualized risk (volatility) and return metrics — for the whole portfolio, or per investment with breakdown=true. Use this for 'how risky is my portfolio?'.
get_savings_rateCompute the user's savings rate over a period: (income − spending) / income, expressed as a percentage. Uses cash flow analytics. Higher is better; negative means the user spent more than they earned.
get_security_fundamentalsGet master data and valuation fundamentals (P/E, P/B, P/S, F-Score) for a security by ISIN. Use this for 'tell me about this holding' or 'is this stock expensive?'.
list_accountsList all of the user's accounts: depots (where investments live), cash accounts, insurance, etc. Start here when you need to know which accounts exist before drilling in.
list_bookingsList investment bookings: buys, sells, dividends, splits. Use this to see the trade history for a specific security or depot.
list_investmentsList the user's investment holdings (stocks, funds, bonds, ETFs). Returns name, ISIN, type, lots, market value and gain/loss. Use this for 'what do I own?' and 'show me my biggest positions'.
list_transactionsList cash transactions (deposits, withdrawals, fees, interest, transfers). Results are sorted by amount (largest absolute value first), so the top rows answer 'what did I spend most money on?'.
search_symbolsSearch securities by name, ISIN or WKN. Returns the security ID and quote provider needed by get_quotes. Use this to resolve 'Apple' or an ISIN to a tradable security.
whoamiShow which wealthAPI user this session is acting as (name, email, member since). Use this to ground yourself or when the user asks 'which account is this?'.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan37 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 71 days ago12/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year6/10
How Wealthapi compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 75/100
- higher than 45% of 48,255 servers
- Tools
- 21
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 33
- more than 22% of 12,191 servers with a package
What its tools let an agent do: 21 read
Install Wealthapi in Claude Code, Cursor or VS Code
Runs npx -y @wealth_api/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-server -- npx -y @wealth_api/mcp-server
What the publisher says
From the Wealthapi repository's README, as published. We do not edit it. Read it on GitHub
wealthapi-mcp
A small Model Context Protocol (MCP) server that lets Claude (or any MCP-compatible assistant) answer everyday portfolio questions about your wealthAPI account:
"What did I spend the most money on last month?"
"How is my portfolio performing this year?"
"Show me my five biggest positions."
"Which of my investments lost the most value?"
It runs locally on your machine. Your bearer token never leaves your computer.
What is an MCP server?
MCP is an open protocol that lets an AI assistant call tools you control. The assistant runs in one process (e.g. Claude Desktop); the MCP server runs as a separate process you launch. They talk to each other over stdio using JSON-RPC: the assistant writes a tools/call message to the server's stdin, the server runs the tool and writes the result back to its stdout. That's the whole protocol.
Note the distinction: this is an MCP server, not an MCP plugin. There is no such thing as an MCP plugin — plugins (e.g. Claude Code plugins) extend the assistant itself, while an MCP server is a standalone process the assistant connects to over the protocol. Any MCP-compatible client (Claude Desktop, Claude Code, others) can use this server.
Concretely, this repo is a Node script. When Claude Desktop starts it, the script registers its tools, waits for tool calls, and when one arrives, makes an HTTPS request to the wealthAPI REST API on your behalf and returns a text summary. No state, no database, no server to maintain.
Read more at https://modelcontextprotocol.io.
The tools
Auth is a wealthAPI API token (wapikey…) carrying the read scopes (accounts:read, investments:read, transactions:read, profile:read). All tools are read-only.
Accounts & cash flow
Portfolio & performance
Dividends
Market data & profile
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Wealthapi: common questions
- Is Wealthapi MCP server safe?
- Mostly: it is graded B (75/100). Read the Wealthapi safety report
- How do I install Wealthapi?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Wealthapi need an API key?
- Yes. The registry entry asks for
BEARER_TOKEN. - Is Wealthapi maintained?
- The last commit was 110 days ago (2026-07-17). The latest release is v0.1.0.
- How does Wealthapi compare with other MCP servers?
- safety score 75/100 (higher than 45% of 48,255 servers); tools 21 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.