Skip to main content

Assembled MCP Server

  • Updated

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

If you're trying to set up MCP tools for your AI support agents to call during chat conversations (e.g., a get_customer_info tool), see MCP Connectors for Assembled AI instead. That's a separate feature from the data MCP server described in this article.

In this article:

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?

  • Access: MCP is available to Admin users only at the moment.
  • Scope: You connect with your Assembled account. The AI only sees data your user is allowed to access in Assembled.
  • Authentication: Setup uses OAuth — you'll sign in to Assembled when prompted (or connect automatically if you're already logged in).

Start querying Assembled data

Once connected, ask questions in natural language. Here are some examples that show what's possible.

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?"

What's available today

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).

Data history: Assembled MCP queries data available from October 2025 onward. If queries return no data for older periods, that's why — older data isn't currently surfaced through MCP.

Tips and limitations

Choose the right tool for the 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).

Permissions and login

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.

Security

Only connect MCP using your organization's approved AI client and policies. Custom MCP servers can access data your Assembled user can see — treat approvals and credentials like any other integration.

Related articles

Setting 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.

Setup steps

Step 1: Open Connectors in Claude.ai

Open Claude.ai and go to Settings → Connectors.

Step 2: Add a custom connector

Click 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

Click Add.

Step 4: Configure tool permissions

Under Tool permissions, configure 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 these 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.

Setting 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.

Setup steps

Step 1: Open ChatGPT settings

Open ChatGPT and click 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.

Developer mode allows unverified connectors. Read the risk notice and only enable it if you accept those terms for your organization.

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.

Click 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 we recommend keeping these 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.

Related articles

Comments

0 comments

Article is closed for comments.