[{"data":1,"prerenderedAt":776},["ShallowReactive",2],{"navigation":3,"\u002Fdocs\u002Fsettings\u002Fagents":197,"\u002Fdocs\u002Fsettings\u002Fagents-surround":771},[4,11,41,71,81,87,93,103,109,139,157,167],{"title":5,"path":6,"stem":7,"children":8},"Getting Started","\u002Fdocs\u002Fgetting-started","1.docs\u002F1.getting-started\u002F1.index",[9],{"title":10,"path":6,"stem":7},"Documentation",{"title":12,"path":13,"stem":14,"children":15},"Workspace","\u002Fdocs\u002Fworkspace","1.docs\u002F10.workspace\u002F1.index",[16,17,21,25,29,33,37],{"title":12,"path":13,"stem":14},{"title":18,"path":19,"stem":20},"Inbox","\u002Fdocs\u002Fworkspace\u002Finbox","1.docs\u002F10.workspace\u002F2.inbox",{"title":22,"path":23,"stem":24},"Calendar","\u002Fdocs\u002Fworkspace\u002Fcalendar","1.docs\u002F10.workspace\u002F3.calendar",{"title":26,"path":27,"stem":28},"Tasks","\u002Fdocs\u002Fworkspace\u002Ftasks","1.docs\u002F10.workspace\u002F4.tasks",{"title":30,"path":31,"stem":32},"Contacts","\u002Fdocs\u002Fworkspace\u002Fcontacts","1.docs\u002F10.workspace\u002F5.contacts",{"title":34,"path":35,"stem":36},"Documents","\u002Fdocs\u002Fworkspace\u002Fdocuments","1.docs\u002F10.workspace\u002F6.documents",{"title":38,"path":39,"stem":40},"Meeting recorder","\u002Fdocs\u002Fworkspace\u002Fmeeting-recorder","1.docs\u002F10.workspace\u002F7.meeting-recorder",{"title":42,"path":43,"stem":44,"children":45},"Settings","\u002Fdocs\u002Fsettings","1.docs\u002F11.settings\u002F1.index",[46,47,51,55,59,63,67],{"title":42,"path":43,"stem":44},{"title":48,"path":49,"stem":50},"Organisation setup","\u002Fdocs\u002Fsettings\u002Forganisation-setup","1.docs\u002F11.settings\u002F2.organisation-setup",{"title":52,"path":53,"stem":54},"Constitution","\u002Fdocs\u002Fsettings\u002Fconstitution","1.docs\u002F11.settings\u002F3.constitution",{"title":56,"path":57,"stem":58},"Members","\u002Fdocs\u002Fsettings\u002Fmembers","1.docs\u002F11.settings\u002F4.members",{"title":60,"path":61,"stem":62},"Security","\u002Fdocs\u002Fsettings\u002Fsecurity","1.docs\u002F11.settings\u002F5.security",{"title":64,"path":65,"stem":66},"MCP connections","\u002Fdocs\u002Fsettings\u002Fmcp-connections","1.docs\u002F11.settings\u002F6.mcp-connections",{"title":68,"path":69,"stem":70},"Agents","\u002Fdocs\u002Fsettings\u002Fagents","1.docs\u002F11.settings\u002F7.agents",{"title":72,"path":73,"stem":74,"children":75},"Parent offices","\u002Fdocs\u002Fparent","1.docs\u002F12.parent\u002F1.index",[76,77],{"title":72,"path":73,"stem":74},{"title":78,"path":79,"stem":80},"Branding and report templates","\u002Fdocs\u002Fparent\u002Fbranding-and-templates","1.docs\u002F12.parent\u002F2.branding-and-templates",{"title":82,"path":83,"stem":84,"children":85},"Testing with demo files","\u002Fdocs\u002Ftesting-with-demo-files","1.docs\u002F2.testing-with-demo-files\u002F1.index",[86],{"title":82,"path":83,"stem":84},{"title":88,"path":89,"stem":90,"children":91},"Vaults","\u002Fdocs\u002Fvaults","1.docs\u002F3.vaults\u002F1.index",[92],{"title":88,"path":89,"stem":90},{"title":94,"path":95,"stem":96,"children":97},"Billing & plans","\u002Fdocs\u002Fbilling","1.docs\u002F4.billing\u002F1.index",[98,99],{"title":94,"path":95,"stem":96},{"title":100,"path":101,"stem":102},"Parent offices (MFO & funds)","\u002Fdocs\u002Fbilling\u002Fparent-offices","1.docs\u002F4.billing\u002F2.parent-offices",{"title":104,"path":105,"stem":106,"children":107},"Chat & agents","\u002Fdocs\u002Fchat-and-agents","1.docs\u002F5.chat-and-agents\u002F1.index",[108],{"title":104,"path":105,"stem":106},{"title":110,"path":111,"stem":112,"children":113},"Portfolio","\u002Fdocs\u002Fportfolio","1.docs\u002F6.portfolio\u002F1.index",[114,115,119,123,127,131,135],{"title":110,"path":111,"stem":112},{"title":116,"path":117,"stem":118},"Liquid positions","\u002Fdocs\u002Fportfolio\u002Fliquid-positions","1.docs\u002F6.portfolio\u002F2.liquid-positions",{"title":120,"path":121,"stem":122},"Alternatives","\u002Fdocs\u002Fportfolio\u002Falternatives","1.docs\u002F6.portfolio\u002F3.alternatives",{"title":124,"path":125,"stem":126},"Real assets","\u002Fdocs\u002Fportfolio\u002Freal-assets","1.docs\u002F6.portfolio\u002F4.real-assets",{"title":128,"path":129,"stem":130},"Philanthropy","\u002Fdocs\u002Fportfolio\u002Fphilanthropy","1.docs\u002F6.portfolio\u002F5.philanthropy",{"title":132,"path":133,"stem":134},"Costs","\u002Fdocs\u002Fportfolio\u002Fcosts","1.docs\u002F6.portfolio\u002F6.costs",{"title":136,"path":137,"stem":138},"Transactions","\u002Fdocs\u002Fportfolio\u002Ftransactions","1.docs\u002F6.portfolio\u002F7.transactions",{"title":140,"path":141,"stem":142,"children":143},"Forecasts","\u002Fdocs\u002Fforecasts","1.docs\u002F7.forecasts\u002F1.index",[144,145,149,153],{"title":140,"path":141,"stem":142},{"title":146,"path":147,"stem":148},"Cash flow planning","\u002Fdocs\u002Fforecasts\u002Fcash-flow","1.docs\u002F7.forecasts\u002F2.cash-flow",{"title":150,"path":151,"stem":152},"Scenarios","\u002Fdocs\u002Fforecasts\u002Fscenarios","1.docs\u002F7.forecasts\u002F3.scenarios",{"title":154,"path":155,"stem":156},"Tax forecasting","\u002Fdocs\u002Fforecasts\u002Ftax","1.docs\u002F7.forecasts\u002F4.tax",{"title":158,"path":159,"stem":160,"children":161},"Reports","\u002Fdocs\u002Freports","1.docs\u002F8.reports\u002F1.index",[162,163],{"title":158,"path":159,"stem":160},{"title":164,"path":165,"stem":166},"Today and report cadence","\u002Fdocs\u002Freports\u002Ftoday-and-cadence","1.docs\u002F8.reports\u002F2.today-and-cadence",{"title":168,"path":169,"stem":170,"children":171},"Tools","\u002Fdocs\u002Ftools","1.docs\u002F9.tools\u002F1.index",[172,173,177,181,185,189,193],{"title":168,"path":169,"stem":170},{"title":174,"path":175,"stem":176},"Deal flow","\u002Fdocs\u002Ftools\u002Fdeal-flow","1.docs\u002F9.tools\u002F2.deal-flow",{"title":178,"path":179,"stem":180},"Allocation","\u002Fdocs\u002Ftools\u002Fallocation","1.docs\u002F9.tools\u002F3.allocation",{"title":182,"path":183,"stem":184},"Exposure","\u002Fdocs\u002Ftools\u002Fexposure","1.docs\u002F9.tools\u002F4.exposure",{"title":186,"path":187,"stem":188},"Residency","\u002Fdocs\u002Ftools\u002Fresidency","1.docs\u002F9.tools\u002F5.residency",{"title":190,"path":191,"stem":192},"Portfolio news","\u002Fdocs\u002Ftools\u002Fportfolio-news","1.docs\u002F9.tools\u002F6.portfolio-news",{"title":194,"path":195,"stem":196},"Strategies","\u002Fdocs\u002Ftools\u002Fstrategies","1.docs\u002F9.tools\u002F7.strategies",{"id":198,"title":68,"body":199,"description":763,"extension":764,"meta":765,"navigation":766,"path":69,"seo":767,"stem":70,"__hash__":770},"docs\u002F1.docs\u002F11.settings\u002F7.agents.md",{"type":200,"value":201,"toc":751},"minimark",[202,206,215,220,267,272,303,309,313,438,445,449,467,480,486,493,497,500,531,700,723,732,735,739],[203,204,68],"h1",{"id":205},"agents",[207,208,209,210,214],"p",{},"FamilyOFX is built so an AI agent can work on your family office data while a person keeps the final say on changes. Agents connect over MCP at ",[211,212,213],"code",{},"https:\u002F\u002Ffamilyofx.com\u002Fapi\u002Fmcp",".",[216,217,219],"h2",{"id":218},"ways-to-connect","Ways to connect",[221,222,223,236],"table",{},[224,225,226],"thead",{},[227,228,229,233],"tr",{},[230,231,232],"th",{},"Agent",[230,234,235],{},"How it signs in",[237,238,239,251],"tbody",{},[227,240,241,245],{},[242,243,244],"td",{},"Claude, ChatGPT, Copilot, and other MCP apps",[242,246,247,248,214],{},"OAuth. You approve one organisation on the consent page. See ",[249,250,64],"a",{"href":65},[227,252,253,256],{},[242,254,255],{},"Scheduled jobs, servers, agents, and other clients with no browser",[242,257,258,259,263,264,214],{},"An ",[260,261,262],"strong",{},"API key",". Send it as ",[211,265,266],{},"Authorization: Bearer \u003Ckey>",[268,269,271],"h3",{"id":270},"create-an-api-key","Create an API key",[273,274,275,282,293,300],"ol",{},[276,277,278,279,214],"li",{},"Open ",[260,280,281],{},"Settings → Integrations → API keys and Webhooks",[276,283,284,285,288,289,292],{},"Under ",[260,286,287],{},"API keys",", choose ",[260,290,291],{},"Create key"," and name it after where it will run.",[276,294,295,296,299],{},"Turn on ",[260,297,298],{},"Apply every change without approval"," if holdings, money, and every other change should apply straight away. Leave it off and every change waits.",[276,301,302],{},"Copy the key. It is shown once.",[207,304,305,306,308],{},"The key acts as you, in this organisation only. Use it from an agent, a scheduled job, or another service. If you leave the organisation the key stops working. You can switch ",[260,307,298],{}," later on the key. There is no setting in between: a key either waits for every change or applies every change. Owners and admins can create and revoke keys, and the list shows when each key was last used.",[216,310,312],{"id":311},"what-agents-can-do","What agents can do",[221,314,315,325],{},[224,316,317],{},[227,318,319,322],{},[230,320,321],{},"Tool",[230,323,324],{},"Use",[237,326,327,337,347,367,386,405,415,428],{},[227,328,329,334],{},[242,330,331],{},[211,332,333],{},"get_portfolio_summary",[242,335,336],{},"Consolidated NAV, allocation, currency exposure, and largest holdings.",[227,338,339,344],{},[242,340,341],{},[211,342,343],{},"portfolio_analytics",[242,345,346],{},"NAV split by legal entity, custodian, asset type, or currency. Cash flows by month, quarter, or year.",[227,348,349,364],{},[242,350,351,354,355,354,358,354,361],{},[211,352,353],{},"positions",", ",[211,356,357],{},"transactions",[211,359,360],{},"costs",[211,362,363],{},"cashflow_plans",[242,365,366],{},"Search holdings, transactions, costs, and forecast rows.",[227,368,369,383],{},[242,370,371,354,374,354,377,354,380],{},[211,372,373],{},"contacts",[211,375,376],{},"companies",[211,378,379],{},"legal_entities",[211,381,382],{},"deals",[242,384,385],{},"CRM and structure lookups.",[227,387,388,402],{},[242,389,390,354,393,354,396,354,399],{},[211,391,392],{},"tasks",[211,394,395],{},"calendar_events",[211,397,398],{},"documents",[211,400,401],{},"product_docs",[242,403,404],{},"Tasks, meetings, files already in FamilyOFX, and product help.",[227,406,407,412],{},[242,408,409],{},[211,410,411],{},"\u003Cname>_write",[242,413,414],{},"Proposes a change to that record type. Returns an approval id and link.",[227,416,417,425],{},[242,418,419,354,422],{},[211,420,421],{},"list_pending_approvals",[211,423,424],{},"get_approval_status",[242,426,427],{},"Follow what is waiting and what was accepted.",[227,429,430,435],{},[242,431,432],{},[211,433,434],{},"batch_import_from_document",[242,436,437],{},"Import holdings or transactions from a document already uploaded.",[207,439,440,441,444],{},"Read results include structured data, and records with a page in FamilyOFX carry a ",[211,442,443],{},"url"," the agent can give you.",[216,446,448],{"id":447},"approvals","Approvals",[207,450,451,452,455,456,459,460,462,463,466],{},"Changes never apply silently. Each ",[211,453,454],{},"_write"," call creates a pending approval in ",[260,457,458],{},"AI Agents",". The agent can call ",[211,461,424],{}," to see the result, or receive the ",[211,464,465],{},"approval.decided"," webhook.",[207,468,469,470,354,472,475,476,479],{},"An owner or admin can let one MCP connection change ",[260,471,392],{},[260,473,474],{},"calendar events",", or ",[260,477,478],{},"document links"," without approval. Holdings, money, and records with history still wait for that connection.",[207,481,482,483,485],{},"An API key is all or nothing. Leave ",[260,484,298],{}," off and every change waits. Turn it on and every change applies, including holdings and money.",[207,487,488,489,492],{},"A client that asks only for the ",[211,490,491],{},"ofx:read"," scope gets read tools only.",[216,494,496],{"id":495},"webhooks","Webhooks",[207,498,499],{},"Webhooks tell an agent, a warehouse, or another service when something happens, so it does not need to keep checking.",[273,501,502,506,514,521],{},[276,503,278,504,214],{},[260,505,281],{},[276,507,284,508,288,510,513],{},[260,509,496],{},[260,511,512],{},"Add webhook",", enter a public https URL, and pick events.",[276,515,516,517,520],{},"Copy the signing secret. It is shown once. Use ",[260,518,519],{},"Send test"," to check delivery.",[276,522,278,523,526,527,530],{},[260,524,525],{},"Deliveries"," to see recent attempts, or ",[260,528,529],{},"Replay"," to send stored events again from a chosen time.",[221,532,533,543],{},[224,534,535],{},[227,536,537,540],{},[230,538,539],{},"Event",[230,541,542],{},"Sent when",[237,544,545,554,574,588,602,616,630,644,658,672,686],{},[227,546,547,551],{},[242,548,549],{},[211,550,465],{},[242,552,553],{},"An approval is accepted or rejected. Includes ids of created records.",[227,555,556,568],{},[242,557,558,561,562,561,565],{},[211,559,560],{},"position.created"," \u002F ",[211,563,564],{},"updated",[211,566,567],{},"deleted",[242,569,570,571,573],{},"A holding is created, edited, or removed. ",[211,572,564],{}," also fires when a transaction changes the holding.",[227,575,576,585],{},[242,577,578,561,581,561,583],{},[211,579,580],{},"transaction.created",[211,582,564],{},[211,584,567],{},[242,586,587],{},"A transaction is recorded, edited, or removed.",[227,589,590,599],{},[242,591,592,561,595,561,597],{},[211,593,594],{},"cost.created",[211,596,564],{},[211,598,567],{},[242,600,601],{},"A cost is created, edited, or removed.",[227,603,604,613],{},[242,605,606,561,609,561,611],{},[211,607,608],{},"document.created",[211,610,564],{},[211,612,567],{},[242,614,615],{},"A document or note is uploaded, edited, or removed.",[227,617,618,627],{},[242,619,620,561,623,561,625],{},[211,621,622],{},"contact.created",[211,624,564],{},[211,626,567],{},[242,628,629],{},"A contact is created, edited, or removed.",[227,631,632,641],{},[242,633,634,561,637,561,639],{},[211,635,636],{},"company.created",[211,638,564],{},[211,640,567],{},[242,642,643],{},"A company is created, edited, or removed.",[227,645,646,655],{},[242,647,648,561,651,561,653],{},[211,649,650],{},"legal_entity.created",[211,652,564],{},[211,654,567],{},[242,656,657],{},"A legal entity is created, edited, or removed.",[227,659,660,669],{},[242,661,662,561,665,561,667],{},[211,663,664],{},"deal.created",[211,666,564],{},[211,668,567],{},[242,670,671],{},"A deal is created, edited, or removed.",[227,673,674,683],{},[242,675,676,561,679,561,681],{},[211,677,678],{},"task.created",[211,680,564],{},[211,682,567],{},[242,684,685],{},"A task is created, edited, or removed.",[227,687,688,697],{},[242,689,690,561,693,561,695],{},[211,691,692],{},"calendar_event.created",[211,694,564],{},[211,696,567],{},[242,698,699],{},"A calendar event is created, edited, or removed.",[207,701,702,703,706,707,710,711,714,715,718,719,722],{},"Each delivery is a JSON ",[211,704,705],{},"POST"," with a delivery ",[211,708,709],{},"id",", a stable ",[211,712,713],{},"eventId",", the event type, the organisation id, and record ids only. Fetch the current record with MCP tools or the SDK. The ",[211,716,717],{},"x-ofx-signature"," header is ",[211,720,721],{},"t=\u003Cunix time>,v1=\u003CHMAC-SHA256 of \"\u003Ct>.\u003Cbody>\">"," using your signing secret. Check it, and reject old timestamps.",[207,724,725,726,728,729,731],{},"Deliveries are queued. FamilyOFX retries with exponential backoff (up to eight attempts, starting at 30 seconds) on network errors, HTTP 429, and 5xx. Other 4xx responses fail immediately. A webhook pauses after 20 failed events in a row. Delivery history is kept for 30 days. Replay keeps the same ",[211,727,713],{}," and mints a new delivery ",[211,730,709],{},"; receivers should dedupe on both.",[207,733,734],{},"Warehouse connectors (for example Databricks or Snowflake) live outside FamilyOFX. They subscribe to these webhooks, then upsert or delete rows through the SDK. Use an SDK list for the initial backfill; use replay only to catch up within the 30-day window.",[216,736,738],{"id":737},"limits","Limits",[740,741,742,745,748],"ul",{},[276,743,744],{},"One organisation per connection or key.",[276,746,747],{},"No payments, transfers, or deletes over MCP.",[276,749,750],{},"Documents must be uploaded in FamilyOFX before an agent can read or import them.",{"title":752,"searchDepth":753,"depth":753,"links":754},"",2,[755,759,760,761,762],{"id":218,"depth":753,"text":219,"children":756},[757],{"id":270,"depth":758,"text":271},3,{"id":311,"depth":753,"text":312},{"id":447,"depth":753,"text":448},{"id":495,"depth":753,"text":496},{"id":737,"depth":753,"text":738},"Connect AI agents and automations to FamilyOFX with MCP, API keys, and webhooks. Tools, approvals, and limits.","md",{},true,{"title":768,"description":769},"FamilyOFX for AI agents","MCP server, API keys for jobs and services, signed webhooks, read-only scopes, and the approval model for agents working on family office data.","xs6Jx5ZQNXWQ09vCljttVyMZsIanKgQNJWxF7fT9-tg",[772,774],{"title":64,"path":65,"stem":66,"description":773,"children":-1},"Connect Claude, ChatGPT, or Microsoft 365 Copilot to your FamilyOFX organisation, approve access, and manage AI connectors.",{"title":72,"path":73,"stem":74,"description":775,"children":-1},"Multi-family office and fund house parent shell, clients, and branding.",1795185572576]