wlthy
Model Context Protocol

Connect your AI assistant to your wealth ledger.

Ask about your global assets, partner splits, or live net worth right inside Claude, ChatGPT, Cursor or Grok. Read-only by default, cryptographically secured, and scoped to a token you control.

Built on wlthy's encrypted ledgerEvery answer traceable to your ledgerRead-only, never writes
MCP Endpoint (Streamable HTTP)
https://wlthy.io/mcp
Get in BlackOpen in ChatGPT

00 · In plain words

New to this? Start here.

A few terms appear on this page. None of them need a developer. Here's each one in one sentence.

MCP (Model Context Protocol)
The standard way an AI assistant like Claude or ChatGPT plugs into an outside service — think of it as a universal adapter between your AI and wlthy.
Token
A long secret you create for the AI, like an app-specific password. It only lets the AI read your numbers, never change anything, and you can switch it off with one click.
Read-only
The AI can look at your portfolio and answer questions, but it can never edit, delete, or move anything. There is no money-movement feature anywhere in wlthy.
Streamable HTTP
Just the secure web connection the AI uses to reach wlthy, the same kind of encrypted link (https://) your browser uses for any website.
Shim (mcp-remote)
A tiny helper that Claude Desktop needs to talk to wlthy. You paste one line of setup, and there is nothing to install or understand beyond that.

01 · What you can ask

Real questions for your AI.

The interface is natural language. You don't need to know table names or JSON structures. Ask the way you'd ask your financial advisor.

NET WORTH

“What's my total net worth in EUR, and how much is liquid cash?”

ALLOCATION

“How am I allocated by country and asset class?”

PARTNER SPLITS

“List all real estate assets where my spouse holds more than 30% equity.”

AI PARSING

“Parse this attached PDF broker statement and stage the positions for my review.”

02 · The toolset

Ten capabilities in one server.

The server ties directly into your encrypted ledger. You never have to work out which endpoint to call; the model routes it automatically.

get_net_worth

Returns total net worth with 1-day and 30-day deltas, plus asset and debt totals and a count of anything still unvalued.

list_portfolios

Lists every portfolio in the account (id, name, base currency) so the agent can scope the rest of its questions.

list_assets

Fetch detailed positions (active or sold) with pagination and live FX rates. The sold lens returns exit price, fees and taxes.

get_asset

Full detail for a single holding plus its 30-day value history, for a deep dive on one position.

get_allocation

Granular breakdown by asset class, geography, or currency — the concentration view, on demand.

net_worth_by_country

Assets, debts AND net worth bucketed by country, with percentages and provenance. Debt country is derived from the asset it's secured against.

list_debts

Every debt item by item: balance, currency, the asset it's linked to, and its derived country. Interest rate and maturity surface when you've entered them.

list_flows

Recurring income and expenses with a monthly-equivalent figure and derived country, the cash-flow side of the picture, on demand.

get_recap

Period-end balances (not naive sums) across net worth, class, sector or crypto, on a daily, monthly or quarterly basis.

parse_document

Hands the agent a statement (PDF / CSV / image) to stage extraction for your manual approval. Nothing is saved until you confirm.

03 · Integration guide

Setup takes under a minute.

Create a read-only token in Settings → API & MCP (Black plan), then drop it into your client config below. Replace wlthy_mcp_YOUR_TOKEN with the token you minted.

ChatGPT

Approved on the ChatGPT app store. Click the button below, sign in with your ChatGPT account, and OpenAI walks you through the OAuth consent screen. No JSON file, no shim, no manual token — wlthy only sees the finished handshake.

chatgpt.com/apps/wlthy

Requires a signed-in ChatGPT account. Free, Plus, and Team plans all work.

Open in ChatGPT

Direct install URL — keep this bookmarked if you need to reconnect: https://chatgpt.com/apps/wlthy/asdk_app_6a21d188c1788191893deb2d369a4aed

Claude Desktop

Open Settings › Developer › MCP Servers, add the config below, then restart Claude. The mcp-remote shim bridges Claude's local transport to the HTTP endpoint (a tiny one-line helper you just paste, nothing to install).

claude_desktop_config.json
{
  "mcpServers": {
    "wlthy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://wlthy.io/mcp",
        "--header",
        "Authorization: Bearer wlthy_mcp_YOUR_TOKEN"
      ]
    }
  }
}

Cursor IDE

Add wlthy to your global ~/.cursor/mcp.json. Cursor speaks Streamable HTTP natively — no shim needed. See the Cursor MCP docs.

~/.cursor/mcp.json
{
  "mcpServers": {
    "wlthy": {
      "url": "https://wlthy.io/mcp",
      "headers": {
        "Authorization": "Bearer wlthy_mcp_YOUR_TOKEN"
      }
    }
  }
}

Grok

Open grok.com/connectors (Business or Enterprise plan), click New Connector → Custom, paste the fields below. Grok auto-discovers all 10 read-only tools. No JSON file to edit, no shim to install.

grok.com/connectors → New Custom
URL
https://wlthy.io/mcp
Auth
Bearer Token
Token
wlthy_mcp_YOUR_TOKEN