Assembled MCP Server

The Assembled MCP server lets you connect Assembled to AI tools like Claude and ChatGPT so you can ask questions about your workforce and support data in plain English — no exports, no spreadsheets, no analyst in the loop.

Server URL: https://data.mcp.assembledhq.com/mcp

Why use the Assembled MCP server?

The Assembled MCP server brings your workforce and support data into the AI tools your team already uses. With it, you can:

• Get answers in seconds, not hours. Ask operational questions in plain English instead of waiting on a report, export, or analyst Slack thread.
• Combine Assembled data with the rest of your stack. Your AI tool can join Assembled with HRIS, BI tools, incident trackers, and anything else it has access to.
• Generate exec summaries, root-cause analyses, and audits on demand. No more rebuilding the same Monday deck every week.

Who can use MCP?

You connect with your own Assembled account. The AI only sees data your user is allowed to access in Assembled. Setup uses OAuth — you'll sign in to Assembled when prompted, or connect automatically if you're already logged in.

What data does MCP access?

The Assembled MCP only connects to your Assembled account. The AI can see the data your Assembled admin user already has access to — nothing more. That data is strictly workforce management information: schedules, forecasts, adherence, and performance metrics. It does not touch patient data or any other systems outside Assembled.

Does MCP give AI agents access to my systems?

No. The Assembled MCP data server is completely separate from Assembled's AI agents, which handle autonomous customer case resolution. Enabling MCP does not activate AI agents or give them access to your systems. MCP is simply a way for your WFM admins to query Assembled data using tools like Claude or ChatGPT.

What can I query with MCP?

MCP connects to Assembled's APIs and metrics platform. Current capabilities include:

Analytics / metrics

• Browse the metrics catalog (namespaces, metrics, dimensions).
• Run flexible metric queries for agent, team, queue, SLA, CSAT, and related operational metrics.

What you can query depends on which metrics namespaces are enabled for your company.

Forecasts

• Forecasted vs actual (volume, handle time, service level, staffing).
• List and create forecast adjustments (creating adjustments requires approving that tool).
• List and create forecast outliers.

Workforce configuration

• Resolve queue, site, team, skill, and channel names to the IDs other tools need.

Scheduling

• Read schedules (shifts and activities for agents in a time window).
• Agent time summaries (overtime, PTO, and voluntary time off totals).

Overtime and voluntary time off (OT / VTO)

• View existing OT and VTO slots.
• Publish new OT and VTO slots (creating slots requires approving that tool).

What are some example questions I can ask?

Once connected, ask questions in natural language. Here are some examples.

Diagnosing SLA misses

"Where and why did we miss SLA last week? Break it down by interval and tell me whether it was shrinkage, AHT, or volume."

Scenario planning

"If volume jumps 25% next week, where do we go into deficit, and what RPH do we need to still hit SLA?"

Vendor / BPO oversight

"Which BPO partner is delivering the best $/CSAT this quarter?"

Cross-system analysis

"Pull hire dates from HRIS. If I exclude agents with less than 90 days tenure, does the AHT creep persist?"

Real-time intraday

"Chat actuals are well below forecast. Find anything in the last 24 hours that explains it."

Quick lookups

• "What was our SLA last week by team?"
• "Show handle time by queue for the past 7 days."
• "How did forecasted volume compare to actuals for phone last week?"
• "Who is on the schedule tomorrow for the Billing queue?"
• "How much overtime does each agent have this week?"

How do I choose the right tool for my question?

• Broad performance and SLA questions → metrics tools (get_metrics_catalog_and_query_usage, then query_metrics).
• Forecast vs actual comparisons → forecast tools (for example, get_forecasted_vs_actual).
• Who is working when → schedule tools (for example, get_schedule).

If OAuth fails or tools return authorization errors, confirm you have the right Assembled permissions and that you're logged into Assembled in the same browser session.

How do I set up Assembled MCP in Claude.ai?

Server URL: https://data.mcp.assembledhq.com/mcp

Before you begin:

• You need an Admin Assembled account (or the appropriate MCP access permission — check with your Assembled admin if you're unsure).
• You'll sign in to Assembled via OAuth during setup, so make sure you have your login ready.

Step 1: Open Connectors in Claude.ai

Open Claude.ai and go to Settings > Connectors.

Step 2: Add a custom connector

Select Add custom connector.

Step 3: Enter the Assembled MCP details

In the dialog that appears, enter:

• Name: Assembled
• Remote MCP server URL: https://data.mcp.assembledhq.com/mcp

Select Add.

Step 4: Configure tool permissions

Under Tool permissions, enable at least:

• get_metrics_catalog_and_query_usage
• query_metrics

We recommend Needs approval when you first connect. You can allow additional tools (forecasts, schedule, and so on) as you use them. Some tools can create forecast adjustments or OT/VTO slots, so keep those on Needs approval until you're ready to let the AI act on your behalf.

Step 5: Sign in to Assembled

When prompted, log in to Assembled to complete OAuth (or connect automatically if you're already logged in).

Step 6: Test the connection

Start a new chat in Claude and try a question like:

"What Assembled metrics can I analyze?"

If Claude returns results, you're connected.

Troubleshooting

OAuth fails or tools return authorization errors. Confirm you have the right Assembled permissions and that you're logged into Assembled in the same browser session.

Tools aren't showing up. Check that you enabled them under Tool permissions in the connector settings.

How do I set up Assembled MCP in ChatGPT?

Server URL: https://data.mcp.assembledhq.com/mcp

Before you begin:

• You need an Admin Assembled account (or the appropriate MCP access permission — check with your Assembled admin if you're unsure).
• You need a ChatGPT account that supports custom apps and developer mode.
• You'll sign in to Assembled via OAuth during setup, so make sure you have your login ready.

Step 1: Open ChatGPT settings

Open ChatGPT and select your profile (bottom left) → Settings.

Step 2: Go to Apps

In Settings, go to Apps.

Step 3: Turn on Developer mode

Open Advanced settings and turn on Developer mode.

Step 4: Create a custom app

Go back to Apps. You should see a Create app button next to Advanced Settings. If you don't, refresh the page.

Select Create app and enter:

• Name: Assembled MCP (or any name you prefer)
• Description (optional): Access data from Assembled
• MCP server URL: https://data.mcp.assembledhq.com/mcp
• Authentication: OAuth

Step 5: Review and save

Review Advanced OAuth settings if shown, then continue. Check the box to acknowledge that custom MCP servers introduce risk, then save the app.

Some tools can create forecast adjustments or OT/VTO slots, so keep those on approval-required until you're ready to let the AI act on your behalf.

Step 6: Sign in to Assembled

When prompted, sign in to Assembled to complete OAuth.

Step 7: Test the connection

Start a new chat in ChatGPT, select your Assembled app if required, and test with a question like:

"What Assembled metrics can I analyze?"

If ChatGPT returns results, you're connected.

Troubleshooting

The connection fails. Return to Apps > Advanced settings and confirm Developer mode is on. Some setups also require Enforce CSP in developer mode to be off so the app can reach the MCP server.

OAuth fails or tools return authorization errors. Confirm you have the right Assembled permissions and that you're logged into Assembled in the same browser session.

You don't see a Create app button. Refresh the page after turning on Developer mode. If it still doesn't appear, confirm your ChatGPT plan supports custom apps.