Before you start
Brokers Alliance registers the email address of the principal for your hierarchy first. Sign in with that exact account when the connection asks. If your address has not been registered, the sign-in is refused, and that is by design. Ask your Brokers Alliance contact to add it.
The connection address you will paste is the same for every assistant:
https://case-nerve-eysvpxsjpq-uc.a.run.app/mcpCopy it exactly, including /mcp at the end.
Connect
Claude (claude.ai or Claude Desktop)
- Open Settings, then Connectors.
- Choose Add custom connector.
- Name it
MyAdvisorDataand paste the connection address above. Leave every advanced field blank. - Click Add, then Connect.
- A Brokers Alliance sign-in page opens. Choose Continue with Google or Continue with Microsoft and use the registered account.
- Back in Claude, start a new chat and ask: Which hierarchy am I connected to?
If a question later says the connection changed, open Connectors, disconnect MyAdvisorData and connect it again. Claude reads the connection's abilities once, at connect time.
ChatGPT (Plus, Pro, Team or Enterprise)
- Open chatgpt.com/plugins (Apps), then Add, then Create MCP App.
- Name it
MyAdvisorDataand paste the connection address above. - Authentication: choose OAuth. Leave the advanced OAuth settings blank.
- Tick the acknowledgment box and click Create, then Continue.
- A Brokers Alliance sign-in page opens. Choose Continue with Google or Continue with Microsoft and use the registered account.
- In a new chat, enable the MyAdvisorData app and ask: Which hierarchy am I connected to?
If the Connect button keeps spinning after a failed first attempt, open the app's settings, choose Delete app, and create it again. Uninstall alone does not clear it.
What you can ask
- Which hierarchy am I connected to? How many agents it covers, when the roster was last refreshed, and what can and cannot be seen.
- Where is case 123456? Status and status date for one case placed through Brokers Alliance by an agent in your hierarchy, by case id or by policy number plus carrier.
- What is still outstanding on case 123456? Open requirements, who they are waiting on (agent, applicant, carrier, MGA, vendor), request and follow-up dates.
- Where does agent 7654321 stand on contracting? Carrier appointment status for one agent and the Brokers Alliance intake records for that contact.
- Show my submitted and paid counts by month. Whole-hierarchy counts for a chart or table, by status category and top carriers. Available once your book has passed the reconcile check.
- Who asked what? The ledger of every question made with your hierarchy's access.
What it never answers
- A case that belongs to another hierarchy. It gets the same answer as a case id that does not exist.
- Commission levels, contract levels, overrides or compensation of any kind.
- Applicant names, health details, notes or documents. Requirement names only.
- Anything it cannot prove. When a source is slow or a row is missing, the answer says unknown or incomplete and gives the reason.
Read the acknowledgment
Access, downlines and turning it off
One connection per hierarchy, held by the principal Brokers Alliance registered. Downline agents get no access until the principal asks Brokers Alliance to enable named users, and each named user signs in with their own account.
To end access for one person or for the whole hierarchy, tell your Brokers Alliance contact. Revocation takes effect on the next question. It ends future access; it cannot recall an answer already delivered.
If a person leaves your organisation, say so the same day.
Something is not working
- The sign-in refused my account. The address is not registered for a hierarchy. Send your Brokers Alliance contact the exact email you used.
- Every answer says hierarchy retired. Your hierarchy changed on our side and the connection closed itself. Brokers Alliance re-points it; nothing to do in your assistant.
- Answers are slow. Evenings and weekends read live and can take a minute or two. Weekday answers come from a snapshot refreshed every two hours.
- The assistant does not list MyAdvisorData. Disconnect and reconnect it (Claude) or delete and recreate the app (ChatGPT).