MCP Server
Connect assistants to your white-label agency for projects, clients, team members, and portal links.
The agency MCP Server connects assistants such as Claude to your white-label agency layer, the same operations you use to run the reseller side of the product. Through plain-language chat, an authorized assistant can help you manage customer businesses (projects), clients who sign in to your branded portal, agency team members, which parts of the console each person may see, and extra sidebar links shown to every client.
This is not the same surface as a single-project MCP connection. Project MCP is where assistants work inside one business (customers, review requests, reviews, ratings, feedback, messages, locations, and related day-to-day reputation work). Agency MCP stays above that. It provisions and governs businesses and people, but it does not expose per-project review feeds or customer lists.
MCP (Model Context Protocol) is the shared standard both connections use. Only the scope changes (whole agency versus one project).
Need to pull reviews, ratings, or feedback for a specific client? Connect the assistant with project MCP on that project (or switch connectors), not the agency URL alone. See Project MCP Server.
For a complete list of tools the assistant can call, see Tools.
Open the agency MCP Server page
Sign in to your console.
Open the Agency area from the header (available when you run a white-label agency plan).
In the sidebar, choose MCP Server.
You will see a short explanation, a field labeled MCP Server URL with your agency's address ready to copy, and a link to documentation. Always copy that full value. Agency MCP uses the platform API host (not your optional White Label API domain from domain setup), so the connection stays reliable when assistants register and sign in.
Below that, Connected apps lists assistants or other tools that have already signed in through this connection. Each tile shows when they connected and what level of access they were granted. You can Revoke any connection you no longer trust.
Connect an assistant
Exact menus change over time, but the pattern matches other MCP integrations.
Open your assistant's settings and find Connectors or Integrations.
Choose Add custom connector (or the equivalent).
Paste the MCP Server URL you copied from Agency → MCP Server. Use the full address from the copy box exactly as shown.
Save the connector. The assistant opens a sign-in window for your platform account.
Complete sign-in, then on the Authorize screen choose your agency (when you use the copied URL, that choice is usually fixed to the right agency), review the permission levels, and approve.
After authorization, the assistant appears under Connected apps on the agency MCP Server page. You can start asking it to help with reseller-level tasks in chat.
Reuse the same documentation habits as a project MCP connection. For example, mention your product name in the first message so the assistant picks the right connector when you use several.
An authorized assistant can change which businesses exist, who may access them, and sending limits or caps. It can also reveal or replace a client business's Project API secret key. Only connect tools you trust, and review confirmations before approving actions that delete a project, roll a secret key, remove a client or team member, or otherwise unwind onboarding.
What this connection is built for
The agency MCP layer mirrors what the agency console is responsible for at the reseller level.
Customer businesses (projects)
Assistants can help with the lifecycle of each client business under your agency: listing them, creating new ones, temporarily suspending or restoring access, copying an existing setup into a new business when you need a template, adjusting plan-style overrides (such as caps on customers, locations, seats, links, tags, widgets, optional modules like advanced forms or ambassador tools), tuning email and SMS request limits so sending stays within what you allow for each client, retrieving or rotating a business's Project API secret key when you need to connect that client's own automation, and removing a business when someone is fully offboarded.
Clients (portal users)
Assistants can list people invited as clients, send invitations with an appropriate role, choose which businesses they may open, limit which console areas they see, resend a stalled invitation, update access after roles or assignments change, and remove a client seat.
Agency team members
Assistants can list internal teammates on the agency, invite new staff, resend invites, and remove someone who should no longer have agency-wide access.
Console sections catalog
Assistants can look up the catalog of console areas (stable labels such as reviews, messaging, and similar product surfaces). That list is what you use, often together with client invites, to decide which slices of the product a client role is allowed to see.
External links (client portal sidebar)
Assistants can list, add, rename or retarget, and remove the extra shortcuts that appear in your branded client portal sidebar for everyone. For example "Book online" or your marketing site, next to the core product navigation.
Example prompts (agency scope)
These illustrate realistic reseller chores, not reputation analytics inside a single storefront:
Projects — "List every customer business under our agency and note which are suspended." / "Create a project named Bright Smile Midtown." / "Duplicate Demo Bakery into a new project called Harbor Cafe." / "Raise the monthly email request limit on project 42 to match our enterprise tier." / "Copy the Project API secret key for Bright Smile Midtown into our password manager." / "Roll the Project API secret key for project 42. We offboarded a vendor."
Clients — "Invite alex@clientco.example as a viewer on projects 3 and 7 with only the sections we use for reporting." / "Resend the pending invite for client membership ID 18."
Team — "Who has agency team seats right now?" / "Invite ops@myagency.example to the agency team."
Sections — "What console sections exist so I can narrow what our next client invite sees?"
Portal links — "Add a sidebar link Schedule consult pointing to our Calendly URL." / "Remove external link ID 5."
When you need reviews, ratings, feedback, or customer-level work, switch context to project MCP for the relevant business.
Permissions at a glance
When you authorize, you typically grant three bands of capability. Your assistant only receives actions that match what you approved:
Read
Inspect projects, clients, team members, the sections catalog, and external links, and retrieve a project's secret key
Write
Create or update projects (including limits and overrides), send or adjust invitations and access, and maintain sidebar links
Delete
Remove projects, client seats, team members, or external links when workflows allow it, and roll a project's secret key
These permissions apply to the agency you authorized, not to unrelated spaces or personal accounts.
Disconnect or revoke access
In the assistant. Remove or disable the custom connector in that product's settings. Access stops immediately.
In your agency console. On Agency → MCP Server, under Connected apps, choose Revoke for a specific tile to invalidate that connection while leaving others intact.
Disconnecting does not by itself delete your businesses or portal accounts. It only removes the assistant's ability to act through this agency connection going forward.
If something does not work as expected, see Troubleshooting.
Last updated