thinkchainai/mcpbundles

Execute tools from your enabled bundles directly from Claude, Cursor, and other MCP-compatible AI assistants using the Model Context Protocol.

Download

Download the MCPBundles Hub .mcpb file directly:

Download hub.mcpb

This .mcpb package contains a pre-configured MCP server proxy that connects to the MCPBundles Hub endpoint. Once installed, your AI assistant can discover and execute tools from all your enabled bundles.

Note: This repository hosts .mcpb files for hundreds of bundles. The link above is specifically for the Hub server. See all releases to download individual bundle packages.

What is MCP Bundles?

MCP Bundles is the simplest way to connect AI assistants to real-world tools. Instead of configuring hundreds of individual MCP servers, you:

1. Create bundles of tools you need (e.g., "Marketing Tools", "Developer Workflow")
2. Connect providers with secure OAuth or API keys once
3. Use one MCP URL per bundle - all your tools instantly available

With 500+ provider integrations including GitHub, Slack, Notion, Google Drive, Salesforce, Stripe, and more, MCP Bundles eliminates the complexity of MCP server management while giving your AI assistant powerful, authenticated access to the services you use every day.

What is the Hub MCP Server?

The MCP Bundles Hub MCP Server provides direct access to tools from all your enabled bundles through a single MCP endpoint. Instead of configuring each bundle separately, you can:

• Execute Tools: Run any tool from your enabled bundles through one interface
• List Available Tools: Discover what tools are available across all your bundles
• Search Tools: Find tools by name, provider, or capability
• Check Readiness: Verify bundle configuration and credential status
• Get Tool Details: View parameters, descriptions, and usage for specific tools

This server is authenticated and tied to your MCPBundles account. It aggregates all your bundle tools into one convenient MCP server endpoint.

Features

• OAuth & API Key Authentication: Secure access via OAuth login or Bearer token
• Unified Access: Execute tools from multiple bundles through one endpoint
• Tool Discovery: Search and list all tools you have access to
• Bundle-Aware Execution: Tools automatically use the correct credentials for each bundle
• Readiness Checks: Verify configuration status before executing tools

Documentation

For comprehensive setup guides and usage instructions:

• Model Context Protocol Overview
• Setting Up MCP in Cursor
• Setting Up MCP in Claude Desktop
• App-Level Tools Guide

Quick Start

Prerequisites

• An MCPBundles account (free at mcpbundles.com)
• MCP-compatible client (Claude Desktop, Cursor, etc.)
• Authentication method:
  • OAuth (recommended): One-click authentication in Cursor
  • API Key: Get from your dashboard for Claude Desktop

Setup Methods

Method 1: One-Click Install in Cursor (Recommended)

Cursor supports direct MCP server installation via URL:

1. Open Cursor Settings → Features → MCP
2. Click "Add Server"
3. Paste this URL: https://github.com/thinkchainai/mcpbundles/releases/download/hub-v1.0.0%2Bbuild.8da55d55/hub.mcpb
4. Authenticate with OAuth when prompted

Method 2: Download & Install .mcpb File

1. Download hub.mcpb
2. Double-click the .mcpb file (Claude Desktop will auto-install)
3. Restart Claude Desktop
4. Configure authentication (see Manual Configuration below for API key setup)

Method 3: Manual Configuration

Cursor Setup

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "mcpbundles-hub": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.mcpbundles.com/hub/",
        "--header",
        "Authorization:Bearer ${ACCESS_TOKEN}"
      ],
      "env": {
        "ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}

Claude Desktop Setup

Edit your Claude Desktop config file (Claude menu → Settings → Developer → Edit Config):

{
  "mcpServers": {
    "mcpbundles-hub": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.mcpbundles.com/hub/",
        "--header",
        "Authorization:Bearer ${ACCESS_TOKEN}"
      ],
      "env": {
        "ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}

Note: Replace your_access_token_here with your actual MCPBundles access token from your dashboard.

Example Usage

Once configured, you can ask your AI assistant:

Execute Tools

• "Use the GitHub create_issue tool from my dev-tools bundle"
• "Execute the slack_send_message tool to post an update"
• "Run the notion_create_page tool with title 'Meeting Notes'"

Discover Tools

• "What tools are available in my marketing bundle?"
• "List all GitHub tools I have access to"
• "Search for tools related to 'email'"

Check Status

• "Check if my dev-tools bundle is ready to use"
• "Show me the parameters for the github_create_issue tool"
• "What bundles do I have enabled?"

Available Tools

The Hub MCP server provides tools with the mcpbundles_hub_ prefix:

Bundle Operations

• mcpbundles_hub_list_bundles - List all your bundles
• mcpbundles_hub_get_bundle - Get details about a specific bundle
• mcpbundles_hub_create_bundle - Create a new bundle
• mcpbundles_hub_update_bundle - Update bundle configuration
• mcpbundles_hub_delete_bundle - Delete a bundle

Credential Management

• mcpbundles_hub_list_credentials - List your provider credentials
• mcpbundles_hub_add_credential - Add a new provider credential
• mcpbundles_hub_update_credential - Update an existing credential
• mcpbundles_hub_remove_credential - Remove a credential

Provider Discovery

• mcpbundles_hub_search_providers - Search available providers
• mcpbundles_hub_get_provider_info - Get detailed provider information
• mcpbundles_hub_list_provider_tools - List tools for a specific provider

Account Management

• mcpbundles_hub_get_account_info - View your account details
• mcpbundles_hub_get_usage_stats - Check API usage statistics

Security

The Hub MCP server supports two authentication methods:

1. OAuth (Recommended): Secure browser-based authentication

   • Automatic token refresh
   • Revocable from your dashboard
   • Works seamlessly in Cursor

2. API Keys: Manual Bearer token authentication

   • Generate from your dashboard
   • Ideal for Claude Desktop
   • No expiration (until revoked)

Your credentials are:

• Encrypted in transit (HTTPS/TLS)
• Never exposed to the AI model
• Stored securely in your MCPBundles account
• Revocable at any time from your dashboard

Never share your API keys or include them in public repositories.

How It Works with Your Bundles

The Hub MCP server is for managing your account. Once you create bundles, each bundle gets its own MCP server URL:

https://mcp.mcpbundles.com/bundle/your-bundle-name

Typical Workflow:

1. Use Hub MCP to create a bundle: "Create a bundle called 'dev-tools'"
2. Use Hub MCP to add providers: "Add GitHub and Slack credentials"
3. Use Hub MCP to configure tools: "Enable all GitHub repo tools"
4. Use the Bundle MCP (/bundle/dev-tools) to actually use the tools: "Create a new GitHub issue"

Troubleshooting

"401 Unauthorized" Error

• Check that your access token is valid
• Verify the token in your dashboard at mcpbundles.com/dashboard
• Make sure you're using the correct environment variable name

Tools Not Appearing

• Restart your AI client after adding the MCP server
• Check that "App-Level Tools" is enabled in your dashboard
• Verify the MCP server URL is correct: https://mcp.mcpbundles.com/hub/

Connection Timeout

• Ensure you have internet connectivity
• Check if mcpbundles.com is accessible
• Try refreshing your access token

Support

Need help? We're here for you:

• Email: [email protected]
• Documentation: docs.mcpbundles.com
• Discord: Join our community
• Issues: Open an issue

Related Resources

Official Repositories

• MCPBundles Package Releases - .mcpb bundle files
• MCPBundles Documentation - Full documentation
• Agent Interviews MCP - Our interview platform

MCP Resources

• Model Context Protocol - Official MCP site
• MCP Python SDK
• MCP TypeScript SDK
• MCP Servers Repository

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Built by ThinkChain Inc
Website • Docs • Twitter • Reddit