X1 Wealth MCP Server

This is the Model Context Protocol (MCP) server for X1 Wealth. It allows Claude Desktop and other MCP clients to access your X1 data.

Setup

1. For direct/manual MCP clients, go to your X1 Dashboard → Settings → API Keys and generate a new API key.
2. For direct/manual clients that support custom headers, configure the MCP server like this:

   {
     "mcpServers": {
       "x1-wealth": {
         "url": "https://mcp.x1wealth.com/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_API_KEY"
         }
       }
     }
   }

3. For Claude Desktop custom connectors, use the OAuth connector flow instead of a manual API key. Claude should redirect you to sign in and approve access; there is no place to paste an X1 bearer key into the connector UI.

Opening https://mcp.x1wealth.com/mcp directly in a browser will show an auth error. That endpoint is the protected MCP resource, not a human setup page.

Read Tools

• get_x1_context — Get structured X1 product context, surfaces, and MCP guidance so Claude can reason about what X1 is and how it is meant to be used.
• get_user_capabilities — Get the connected user's X1 entitlements, feature access, subscription context, and MCP scope visibility.
• list_assigned_members — List the managed-program members you can operate on, including the access class and profile policy state for each member.
• get_client_profile — Canonical MCP read for your profile or a profile view for a client/member you can access. Advisors use active relationships, coaches follow managed-program defaults, and scoped admins can use debugAccess for read-only break-glass when eligible. Professional responses may include bounded shared member intelligence such as document-backed facts when policy allows.
• get_client_product_state — Get a structured view of onboarding, Pulse, vault, plays, packet readiness, shared member-intelligence availability, and CRM operating-context readiness for yourself or a client/member you can access.
• get_client_activity — Get a recent activity timeline for yourself or a client/member you can access. Useful for understanding engagement and what changed recently.
• get_family_office_context — Get family constitution, crest, mission, mode-of-operation, and meeting-playbook context for yourself or a client/member you can access.
• get_business_entity_graph_context — Return bounded business-entity graph claims for a member or household, with optional raw claims and evidence.
• get_professional_graph_context — Return bounded professional-graph claims for a client you can access, filtered by review state, with optional evidence.
• get_meeting_prep — Bundle profile, product state, Pulse, plays, recent documents, family-office context, recent activity, shared member intelligence, and CRM operating context for a meeting with yourself or a client/member you can access.
• get_document_content — Read document contents from the vault. Advisors need explicit shares, coaches get managed-program default raw-doc access, and scoped admins can use debugAccess for read-only break-glass when eligible.
• get_document_download_url — Create a short-lived signed URL for a vault document. Use this when you explicitly need the original file. Raw document access follows the same scoped policy as get_document_content, including admin debugAccess escalation.
• get_vault_documents — Canonical MCP read for vault document inventory. Advisors only receive shared documents, while managed-program roles see metadata according to their assignment scope.
• search_documents — Canonical MCP read for vault document metadata and summary search. Advisors search shared documents, while managed-program roles search within their assignment scope.
• get_plays — Get financial strategies (plays) with steps, velocity scores, and ecosystem connections.
• get_pulse_snapshot — Get the latest Pulse financial KPIs: runway months, debt horizon, freedom delta, and data quality indicators.
• get_what_matters_now — Surface the member's prioritised weekly focus items with grounding context and suggested next actions.
• detect_financial_context — Analyze a conversation snippet for financial topics, cross-reference against the user's X1 data, and return structured suggestions for what X1 can help with. Privacy-safe: never includes raw financial numbers.

Write Tools

• create_packet — Assemble an advisor-shareable packet from Pulse, weekly brief, recent plays, and family-office context for a client you can access.
• log_decision — Persist a decision memory entry with category, alternatives considered, grounding snapshot, and next action for a member or advisor client.
• update_play_step — Update a single Play step state for yourself or an accessible client, with an approval gate for irreversible transitions like completed or abandoned.
• request_missing_document — Request a missing document from a managed client or member household. Advisors, coaches, and admins can queue document requests tied to an active advisor-client relationship.
• save_artifact — Save a note, summary, or artifact back to X1. Advisors save to client notes; regular users save to their concierge memory.
• propose_profile_fact — Add evidence-backed profile fact assertions without mutating onboarding. Use for current profile truth such as filed-return AGI, carryovers, filing status, or advisor-attested facts; unresolved tasks belong in log_decision instead.
• retract_profile_fact — Reject or mark a sourced profile fact historical after resolving member access. Use this to clean mistaken/test assertions without ad hoc database edits.
• update_family_constitution — Create or partially update a client's family constitution so family-office preferences captured in conversation can be saved directly into X1.
• update_family_mission — Create or version-update a client's family mission so values, legacy goals, and financial philosophy can be saved from an advisor or co-work session.
• update_family_crest — Create or partially update a client's family crest metadata without generating a new image, so advisor notes can become structured family-office inputs.

Prompts

• financial-check-in — Run a financial health check using your X1 data — Pulse KPIs, active strategies, and recent activity.
• document-finder — Find a specific document in your X1 vault by name, type, or topic.
• tax-planning-session — Review your current tax situation and explore strategies using your X1 data.
• play-progress-review — Review progress on your active financial strategies (plays) — velocity, steps completed, and what's next.
• client-meeting-prep — Prepare a comprehensive brief for an upcoming client meeting using Pulse, shared document-backed intelligence, and CRM operating context when available.
• member-progress-review — Review strategy progress, document-backed intelligence, and engagement for a specific member.

Resources

• x1://status — Your X1 Wealth status snapshot — vault, Pulse, strategies, and key metrics. Updated on each read.

MCP resource URL: https://mcp.x1wealth.com/mcp