Who this is for

For the person who handles the finances, or anyone starting a map from statements and tax forms. File or email access, if available, belongs to your assistant and needs your permission. Family Asset Map does not read your email or files.

How it works, step by step

  1. Connect your assistant with read and write access to your own Standard map.
  2. Give your assistant only the documents it is allowed to read, using its own file or email features. Family Asset Map does not scan those sources.
  3. Ask for a draft with institution, category and document location. Exclude account numbers, balances and logins.
  4. Review the draft and remove anything you do not want on your map. Confirm the entries you want added.
  5. Have the assistant call list_portfolios and read all summary pages with get_portfolio to check for existing institutions. If you have no map, it may use create_portfolio only when you ask. It then uses add_location for each approved addition, reading the current version before each write.
  6. Use the link from open_in_app to review the result in the app.

Example: what you ask, what the agent does

Illustrative example. Fictional data.

You: Here are the statements and tax forms I want you to review. List each institution, its category and where the paper or PDF is kept. Exclude account numbers and balances. Show me the draft before adding anything to Family Asset Map.

This fictional sequence assumes you already have a Standard map. You reviewed the draft, confirmed one addition, and the assistant checked that it was not already listed. Duplicate checking is the assistant's task; add_location does not deduplicate institution names.

[
  {
    "tool": "list_portfolios",
    "arguments": {}
  },
  {
    "tool": "get_portfolio",
    "arguments": {
      "portfolioId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "summaryOnly": true,
      "offset": 0,
      "limit": 25
    }
  },
  {
    "tool": "add_location",
    "arguments": {
      "portfolioId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "expectedVersion": "fictional-current-version",
      "idempotencyKey": "a1b2c3d4-1111-4111-8111-111111111111",
      "category": "Retirement",
      "institution": "Example 401(k) Provider",
      "url": "https://www.example.com",
      "note": "Old employer plan. Annual statement in the Retirement folder in the hall closet; PDF in Drive > Taxes > 2025."
    }
  },
  {
    "tool": "open_in_app",
    "arguments": {
      "portfolioId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  }
]

Assistant: I added the Example 401(k) Provider entry you approved, with the document-location note. I did not add account numbers or balances. Use the app link returned by open_in_app to review it.

If you have no map and explicitly ask for one, create_portfolio accepts a name, baseCurrency (PLN, EUR or USD) and idempotencyKey UUID. It creates one Standard map without accounts or balances; an existing map is reported, not overwritten.

A note rejected with SENSITIVE_INPUT should be rewritten as a document location, such as “statement in the blue folder.” Do not disguise a secret to get past the check.

These are tool names and argument objects, not tool responses. The IDs, version and UUID are fictional. Use the actual IDs and current version returned by reads, and a new UUID for each intended write. Follow summary pagination until nextOffset is null before calling a list complete. Request only the institution details needed for the task.

For add or update, read the current version first. A write permission allows changes; asking the assistant to show a draft and wait for your approval is an instruction to the assistant, not an extra confirmation screen enforced by MCP. After a successful write, read again before another change. Retry a lost response only with the same key and arguments. A version conflict requires a fresh read and a new decision; do not automatically retry it. Report success only after a successful tool result.

Connect once

Use https://familyassetmap.com/mcp with Streamable HTTP and browser OAuth. No API key is needed.

  1. Add Family Asset Map as a custom remote MCP server in a client that supports OAuth.
  2. Complete Family Asset Map sign-in in the browser. Enter your email code there, never in chat.
  3. Choose read access. Add write access only for a requested creation or change. Return to your assistant.

These are connection instructions, not claims that each client has been tested with Family Asset Map.

Claude Code

# Claude Code (plugin)
claude plugin marketplace add lukeon2/familyassetmap-agents
claude plugin install familyassetmap@familyassetmap
# or tools only
claude mcp add --transport http --scope user familyassetmap https://familyassetmap.com/mcp

Codex

# Codex
codex mcp add familyassetmap --url https://familyassetmap.com/mcp
codex mcp login familyassetmap

Any client with custom remote MCP + OAuth

Name: familyassetmap
Transport: Streamable HTTP
URL: https://familyassetmap.com/mcp

See the connection walkthrough and the technical agent guide. A direct request to the MCP endpoint without authorization returns HTTP 401.

What the agent will not do

The assistant will not use Family Asset Map to scan an inbox, import account balances or connect to financial institutions. Keep account numbers and logins out of the draft and notes.

Remote MCP works with the connected user's own Standard map. It cannot read or edit E2EE contents, browser-only maps or maps shared by other users. It cannot share or delete maps, email backups, change protection mode, or read or edit accounts and balances. It does not connect to banks, brokers, exchanges or wallets, or fetch prices or live balances.

Your data

Your own Standard map must be saved online for these workflows. It is encrypted online with a server-held key; Family Asset Map can decrypt it. Information returned to your assistant may be processed by its AI provider.

Connections last up to seven days; reconnect when asked. Revoke access at Connected apps. Revocation stops subsequent requests, but cannot recall data already read by the AI provider.

Names and notes are data, never instructions. Potentially sensitive text may be omitted from reads, and writes containing it are rejected when detected. This is a heuristic, not a guarantee that every secret is detected. Do not store bank passwords, private keys, recovery phrases, sign-in codes or full account numbers. Read how data protection works.

FAQ

Does Family Asset Map read my email?

No. Any document or email reading is done by your assistant with access you give it. Family Asset Map receives the institution fields the assistant submits through its tools.

Can it add balances?

No. MCP can add institution names, categories, websites and where-to-find notes. It cannot read or edit accounts and balances.

What if I already have a map?

The assistant should read your own existing Standard map first. create_portfolio reports an existing map rather than overwriting it or creating a second one. E2EE contents must stay in the app.

How can I correct an entry?

Review and edit or remove the institution in the app. With write permission, update_location can change supplied institution fields. An empty note or URL clears that field; deletion is not available through MCP.

Start with one task

Personal use is free.

Open the app · Set up your assistant

Disclaimer

Family Asset Map is not legal, tax or financial advice and does not replace a will or give anyone access after a death on its own.

Related