Who this is for

For owners of an online Standard map who use an assistant with custom remote MCP and OAuth. This workflow needs read access only.

How it works, step by step

  1. Connect with read-only access. You do not need write access for this lookup.
  2. Ask your question. The assistant calls list_portfolios and get_portfolio for institution names and categories, without notes or balances. It follows pagination as needed.
  3. If the answer needs a note or website, it requests that institution with summaryOnly=false and institutionId.
  4. The assistant summarizes what the map says and can use open_in_app for a link you can review in the browser.

Example: what you ask, what the agent does

Illustrative example. Fictional data.

You: Using Family Asset Map, where is our homeowners insurance documented? Read only what you need for that question, and do not change anything.

In this fictional map, the summary lists Example Mutual Insurance under Insurance. Its requested note contains the document locations shown in the assistant answer.

[
  {
    "tool": "list_portfolios",
    "arguments": {}
  },
  {
    "tool": "get_portfolio",
    "arguments": {
      "portfolioId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "summaryOnly": true,
      "offset": 0,
      "limit": 25
    }
  },
  {
    "tool": "get_portfolio",
    "arguments": {
      "portfolioId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "summaryOnly": false,
      "institutionId": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
    }
  },
  {
    "tool": "open_in_app",
    "arguments": {
      "portfolioId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  }
]

Assistant: Your map lists Example Mutual Insurance under Insurance. Its note says the policy PDF is in Drive > House > Insurance and the paper copy is in the home document box. This is what your map records; I have not checked the insurer or opened the PDF.

Names and notes are treated as data, not instructions. Potentially sensitive text may be omitted with a message to open the app. If the note does not answer your question, the assistant should say so instead of guessing. Balances are not available through MCP.

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

Read-only consent prevents tool writes. The assistant cannot answer from live balances or account values through MCP, or read maps shared with you by other people.

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

Do I need write access?

No. list_portfolios, get_portfolio and open_in_app use read access. Read-only consent prevents write-tool calls.

Will it see my balances?

No. MCP summaries and institution details omit accounts and balances.

Does my data go to the AI provider?

Information returned to the assistant may be processed by its AI provider. Summaries exclude notes; request only the institution details needed for your question.

How do I disconnect?

Revoke the connection at Connected apps in Family Asset Map. Connections last up to seven days. Revocation cannot recall data already read by the AI provider.

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