MCP Bundles Hub MCP Server

1# MCP Bundles Hub MCP Server
2 
3<p align="center">
4  <img src="https://mcpbundles.com/brand/logos/square/logo-square.png" alt="MCP Bundles Logo" width="120" />
5</p>
6 
7<p align="center">
8  <a href="https://mcpbundles.com"><img src="https://img.shields.io/badge/MCP-Compatible-orange?style=flat&logo=ai" alt="MCP Compatible"/></a>
9  <a href="https://mcpbundles.com"><img src="https://img.shields.io/badge/Providers-500+-blue?style=flat" alt="500+ Providers"/></a>
10  <a href="https://github.com/thinkchainai/mcpbundles/releases/latest"><img src="https://img.shields.io/badge/Download-.mcpb-success?style=flat" alt="Download .mcpb"/></a>
11  <a href="https://docs.mcpbundles.com"><img src="https://img.shields.io/badge/Docs-Available-green?style=flat" alt="Documentation"/></a>
12</p>
13 
14> Execute tools from your enabled bundles directly from Claude, Cursor, and other MCP-compatible AI assistants using the Model Context Protocol.
15 
16## Download
17 
18Download the MCPBundles Hub .mcpb file directly:
19 
20**[Download hub.mcpb](https://github.com/thinkchainai/mcpbundles/releases/download/hub-v1.0.0%2Bbuild.8da55d55/hub.mcpb)**
21 
22This `.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.
23 
24> **Note**: This repository hosts `.mcpb` files for hundreds of bundles. The link above is specifically for the Hub server. See [all releases](https://github.com/thinkchainai/mcpbundles/releases) to download individual bundle packages.
25 
26## What is MCP Bundles?
27 
28**MCP Bundles** is the simplest way to connect AI assistants to real-world tools. Instead of configuring hundreds of individual MCP servers, you:
29 
301. **Create bundles** of tools you need (e.g., "Marketing Tools", "Developer Workflow")
312. **Connect providers** with secure OAuth or API keys once
323. **Use one MCP URL** per bundle - all your tools instantly available
33 
34With 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.
35 
36## What is the Hub MCP Server?
37 
38The **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:
39 
40- **Execute Tools**: Run any tool from your enabled bundles through one interface
41- **List Available Tools**: Discover what tools are available across all your bundles
42- **Search Tools**: Find tools by name, provider, or capability
43- **Check Readiness**: Verify bundle configuration and credential status
44- **Get Tool Details**: View parameters, descriptions, and usage for specific tools
45 
46This server is **authenticated** and tied to your MCPBundles account. It aggregates all your bundle tools into one convenient MCP server endpoint.
47 
48## Features
49 
50- **OAuth & API Key Authentication**: Secure access via OAuth login or Bearer token  
51- **Unified Access**: Execute tools from multiple bundles through one endpoint  
52- **Tool Discovery**: Search and list all tools you have access to  
53- **Bundle-Aware Execution**: Tools automatically use the correct credentials for each bundle  
54- **Readiness Checks**: Verify configuration status before executing tools
55 
56## Documentation
57 
58For comprehensive setup guides and usage instructions:
59 
60- [Model Context Protocol Overview](https://docs.mcpbundles.com/overview/mcp)
61- [Setting Up MCP in Cursor](https://docs.mcpbundles.com/how-to/connecting-your-ai#cursor)
62- [Setting Up MCP in Claude Desktop](https://docs.mcpbundles.com/how-to/connecting-your-ai#claude-desktop)
63- [App-Level Tools Guide](https://docs.mcpbundles.com/how-to/app-level-tools)
64 
65## Quick Start
66 
67### Prerequisites
68 
69- An MCPBundles account (free at [mcpbundles.com](https://mcpbundles.com))
70- MCP-compatible client (Claude Desktop, Cursor, etc.)
71- Authentication method:
72  - **OAuth** (recommended): One-click authentication in Cursor
73  - **API Key**: Get from your [dashboard](https://mcpbundles.com/dashboard) for Claude Desktop
74 
75### Setup Methods
76 
77#### Method 1: One-Click Install in Cursor (Recommended)
78 
79Cursor supports direct MCP server installation via URL:
80 
811. Open Cursor Settings → Features → MCP
822. Click **"Add Server"**
833. Paste this URL: `https://github.com/thinkchainai/mcpbundles/releases/download/hub-v1.0.0%2Bbuild.8da55d55/hub.mcpb`
844. Authenticate with OAuth when prompted
85 
86#### Method 2: Download & Install .mcpb File
87 
881. **[Download hub.mcpb](https://github.com/thinkchainai/mcpbundles/releases/download/hub-v1.0.0%2Bbuild.8da55d55/hub.mcpb)**
892. Double-click the `.mcpb` file (Claude Desktop will auto-install)
903. Restart Claude Desktop
914. Configure authentication (see Manual Configuration below for API key setup)
92 
93#### Method 3: Manual Configuration
94 
95#### Cursor Setup
96 
97Add to your Cursor MCP settings:
98 
99```json
100{
101  "mcpServers": {
102    "mcpbundles-hub": {
103      "command": "npx",
104      "args": [
105        "-y",
106        "mcp-remote@latest",
107        "https://mcp.mcpbundles.com/hub/",
108        "--header",
109        "Authorization:Bearer ${ACCESS_TOKEN}"
110      ],
111      "env": {
112        "ACCESS_TOKEN": "your_access_token_here"
113      }
114    }
115  }
116}
117```
118 
119#### Claude Desktop Setup
120 
121Edit your Claude Desktop config file (Claude menu → Settings → Developer → Edit Config):
122 
123```json
124{
125  "mcpServers": {
126    "mcpbundles-hub": {
127      "command": "npx",
128      "args": [
129        "-y",
130        "mcp-remote@latest",
131        "https://mcp.mcpbundles.com/hub/",
132        "--header",
133        "Authorization:Bearer ${ACCESS_TOKEN}"
134      ],
135      "env": {
136        "ACCESS_TOKEN": "your_access_token_here"
137      }
138    }
139  }
140}
141```
142 
143**Note:** Replace `your_access_token_here` with your actual MCPBundles access token from your dashboard.
144 
145## Example Usage
146 
147Once configured, you can ask your AI assistant:
148 
149### Execute Tools
150- "Use the GitHub create_issue tool from my dev-tools bundle"
151- "Execute the slack_send_message tool to post an update"
152- "Run the notion_create_page tool with title 'Meeting Notes'"
153 
154### Discover Tools
155- "What tools are available in my marketing bundle?"
156- "List all GitHub tools I have access to"
157- "Search for tools related to 'email'"
158 
159### Check Status
160- "Check if my dev-tools bundle is ready to use"
161- "Show me the parameters for the github_create_issue tool"
162- "What bundles do I have enabled?"
163 
164## Available Tools
165 
166The Hub MCP server provides tools with the `mcpbundles_hub_` prefix:
167 
168### Bundle Operations
169- `mcpbundles_hub_list_bundles` - List all your bundles
170- `mcpbundles_hub_get_bundle` - Get details about a specific bundle
171- `mcpbundles_hub_create_bundle` - Create a new bundle
172- `mcpbundles_hub_update_bundle` - Update bundle configuration
173- `mcpbundles_hub_delete_bundle` - Delete a bundle
174 
175### Credential Management
176- `mcpbundles_hub_list_credentials` - List your provider credentials
177- `mcpbundles_hub_add_credential` - Add a new provider credential
178- `mcpbundles_hub_update_credential` - Update an existing credential
179- `mcpbundles_hub_remove_credential` - Remove a credential
180 
181### Provider Discovery
182- `mcpbundles_hub_search_providers` - Search available providers
183- `mcpbundles_hub_get_provider_info` - Get detailed provider information
184- `mcpbundles_hub_list_provider_tools` - List tools for a specific provider
185 
186### Account Management
187- `mcpbundles_hub_get_account_info` - View your account details
188- `mcpbundles_hub_get_usage_stats` - Check API usage statistics
189 
190## Security
191 
192The Hub MCP server supports two authentication methods:
193 
1941. **OAuth (Recommended)**: Secure browser-based authentication
195   - Automatic token refresh
196   - Revocable from your dashboard
197   - Works seamlessly in Cursor
198 
1992. **API Keys**: Manual Bearer token authentication
200   - Generate from your dashboard
201   - Ideal for Claude Desktop
202   - No expiration (until revoked)
203 
204Your credentials are:
205- Encrypted in transit (HTTPS/TLS)
206- Never exposed to the AI model
207- Stored securely in your MCPBundles account
208- Revocable at any time from your dashboard
209 
210**Never share your API keys or include them in public repositories.**
211 
212## How It Works with Your Bundles
213 
214The Hub MCP server is for **managing your account**. Once you create bundles, each bundle gets its own MCP server URL:
215 
216```
217https://mcp.mcpbundles.com/bundle/your-bundle-name
218```
219 
220**Typical Workflow:**
221 
2221. Use **Hub MCP** to create a bundle: "Create a bundle called 'dev-tools'"
2232. Use **Hub MCP** to add providers: "Add GitHub and Slack credentials"
2243. Use **Hub MCP** to configure tools: "Enable all GitHub repo tools"
2254. Use the **Bundle MCP** (`/bundle/dev-tools`) to actually use the tools: "Create a new GitHub issue"
226 
227## Troubleshooting
228 
229### "401 Unauthorized" Error
230- Check that your access token is valid
231- Verify the token in your dashboard at [mcpbundles.com/dashboard](https://mcpbundles.com/dashboard)
232- Make sure you're using the correct environment variable name
233 
234### Tools Not Appearing
235- Restart your AI client after adding the MCP server
236- Check that "App-Level Tools" is enabled in your dashboard
237- Verify the MCP server URL is correct: `https://mcp.mcpbundles.com/hub/`
238 
239### Connection Timeout
240- Ensure you have internet connectivity
241- Check if mcpbundles.com is accessible
242- Try refreshing your access token
243 
244## Support
245 
246Need help? We're here for you:
247 
248- **Email**: [support@mcpbundles.com](mailto:support@mcpbundles.com)
249- **Documentation**: [docs.mcpbundles.com](https://docs.mcpbundles.com)
250- **Discord**: [Join our community](https://discord.gg/mcpbundles)
251- **Issues**: [Open an issue](https://github.com/thinkchainai/mcpbundles/issues)
252 
253## Related Resources
254 
255### Official Repositories
256- [MCPBundles Package Releases](https://github.com/thinkchainai/mcpbundles) - .mcpb bundle files
257- [MCPBundles Documentation](https://github.com/thinkchainai/mcp_docs) - Full documentation
258- [Agent Interviews MCP](https://github.com/thinkchainai/agentinterviews_mcp) - Our interview platform
259 
260### MCP Resources
261- [Model Context Protocol](https://modelcontextprotocol.io/) - Official MCP site
262- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)
263- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
264- [MCP Servers Repository](https://github.com/modelcontextprotocol/servers)
265 
266## License
267 
268This project is licensed under the MIT License - see the LICENSE file for details.
269 
270---
271 
272<p align="center">
273  <strong>Built by <a href="https://thinkchain.ai">ThinkChain Inc</a></strong><br/>
274  <a href="https://mcpbundles.com">Website</a> • 
275  <a href="https://docs.mcpbundles.com">Docs</a> • 
276  <a href="https://twitter.com/mcpbundles">Twitter</a> • 
277  <a href="https://reddit.com/r/mcpbundles">Reddit</a>
278</p>
279