Skip to main content

Composing Bundles

Composition lets you combine tools from multiple bundles into a single MCP endpoint. Instead of adding five separate bundle 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 bundles5 URLs in your AI configAI sees all tools from all URLsEach bundle uses its own credential bindings
1 composed bundle1 URLAI sees all tools from 1 URLEach included bundle keeps its own credential bindings
Hub endpoint1 URLDynamic discovery across all enabled bundlesAutomatic per-bundle routing

Composition is best when you want a focused, direct-mode MCP server that combines specific bundles — 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 Bundle A inside Bundle B:

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

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

Step-by-Step: Including a Bundle​

From a Bundle Detail Page​

  1. Navigate to the bundle 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 bundles
    • Create a new server — Name a new custom bundle

  4. Click the target server, or create one

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

From the Include Dialog​

The "Add to Custom Server" dialog shows:

  • Your existing custom servers — Any bundle 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 bundle'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 bundle already included

Then repeat for additional bundles you want to include.

Managing Composed Servers​

Viewing Included Bundles​

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

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

Adding More Bundles​

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

Removing an Included Bundle​

On the composed bundle's detail page:

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

Execution Mode​

Composed bundles follow the same rules as regular bundles:

  • 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 bundle, click "Add to Custom Server" button in the header, create a new server called "Sales Ops"
  2. Add Resend — Navigate to the Resend bundle, 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 bundles through one URL, but they work differently:

Composed bundles:

  • Direct mode available (faster tool loading for smaller sets)
  • Fixed tool set — you choose exactly which bundles 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 a bundle 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​