Skip to main content

Composing MCP Servers

Composition lets you combine tools from multiple MCP servers into a single MCP endpoint. Instead of adding five separate MCP server URLs to your AI client, compose them into one custom server and use a single URL.

Why Compose?​

ApproachURLs to manageTool discoveryCredential handling
5 separate MCP servers5 URLs in your AI configAI sees all tools from all URLsEach MCP server uses its own credential bindings
1 composed MCP server1 URLAI sees all tools from 1 URLEach included MCP server keeps its own credential bindings
Hub endpoint1 URLDynamic discovery across all enabled MCP serversAutomatic per-server routing

Composition is best when you want a focused, direct-mode MCP server that combines specific MCP servers — without the dynamic discovery overhead of the Hub.

The Hub is best when you want zero configuration and are happy with dynamic execution. See The Hub Endpoint.

How Composition Works​

When you include MCP server A inside MCP server B:

  1. All of MCP server A's tools become available through MCP server B's MCP URL
  2. Credentials stay separate — MCP server A's tools still use MCP server A's credential bindings
  3. No duplication — Tools aren't copied; they're referenced. Updating the source MCP server updates the composed server automatically
  4. Stacks — You can include multiple MCP servers in the same composed server

The composed MCP server is a regular MCP endpoint. It works with ChatGPT, Cursor, Claude Desktop, and any MCP client.

Step-by-Step: Including an MCP Server​

From an MCP Server Detail Page​

  1. Navigate to the MCP server you want to include (the source)

  2. Click "Add to Custom Server" button in the header (compact button in the navigation row)

  3. You'll see two options:

    • Add to existing server — Pick from your custom MCP servers
    • Create a new server — Name a new custom MCP server

  4. Click the target server, or create one

  5. The source MCP server's tools now appear in the target server

From the Include Dialog​

The "Add to Custom Server" dialog shows:

  • Your existing custom servers — Any custom MCP server you've created and enabled
  • Tool count — How many tools each server already has
  • Search — Filter servers by name if you have many
  • Create new — Start a new server right from the dialog

Creating a Composed Server from Scratch​

If you don't have a custom server yet:

  1. Go to any MCP server's detail page
  2. Click "Add to Custom Server" button in the header
  3. Click "Create new server"
  4. Give it a descriptive name (e.g., "Sales Stack", "Marketing Ops")
  5. Add an optional description
  6. Click Create
  7. You're redirected to your new server with the first MCP server already included

Then repeat for additional MCP servers you want to include.

Managing Composed Servers​

Viewing Included MCP Servers​

On your composed MCP server's detail page, you'll see:

  • Included MCP servers — Listed with their tool counts
  • Total tools — Combined count from all included MCP servers
  • Credential status — Whether each included MCP server has valid credentials

Adding More MCP Servers​

Navigate to any MCP server's detail page and click "Add to Custom Server" button in the header to add it to your composed server.

Removing an Included MCP Server​

On the composed MCP server's detail page:

  1. Find the included MCP server in the list
  2. Click the remove action
  3. That MCP server's tools are immediately removed from the server

Execution Mode​

Composed MCP servers follow the same rules as other MCP servers:

  • Under 100 tools: Can use Direct mode (tools load up front)
  • Over 100 tools: Must use Dynamic mode (tool discovery on demand)

If your composed server exceeds 100 tools, switch it to Dynamic mode. See Execution Modes.

Example: Building a Sales Operations Server​

Goal: One MCP URL for your entire sales workflow.

  1. Start with HubSpot — Navigate to the HubSpot MCP server, click "Add to Custom Server" button in the header, create a new server called "Sales Ops"
  2. Add Resend — Navigate to the Resend MCP server, click "Add to Custom Server" → pick "Sales Ops"
  3. Add Stripe — Same process for Stripe
  4. Add Slack — Same process for Slack

Result: Your "Sales Ops" server has tools from HubSpot (contacts, deals), Resend (emails), Stripe (payments, invoices), and Slack (notifications) — all behind one MCP URL.

https://mcp.mcpbundles.com/bundle/sales-ops-a3f

Add this single URL to Cursor or ChatGPT, and your AI can manage the full sales pipeline.

Composition vs Hub​

Both let you access multiple MCP servers through one URL, but they work differently:

Composed MCP servers:

  • Direct mode available (faster tool loading for smaller sets)
  • Fixed tool set — you choose exactly which MCP servers to include
  • Explicit control over what your AI sees
  • One URL per composed server

Hub endpoint:

  • Always Dynamic mode (discovery + code execution)
  • Includes everything you've enabled
  • Zero configuration — enable an MCP server and it appears
  • One URL forever

Use composition when you want curated, focused servers for specific workflows or AI clients.

Use the Hub when you want a single URL that always has everything.

Next Steps​