https://github.com/mcp360/unified-gateway-mcp

Unified MCP Gateway Platform, Marketplace & Custom MCPs
https://github.com/mcp360/unified-gateway-mcp

agent-tools agentic-ai ai-agents claude developer-tools mcp mcp360 model-context-protocol no-code workflow-automation

Last synced: 4 months ago
JSON representation

Unified MCP Gateway Platform, Marketplace & Custom MCPs

Host: GitHub
URL: https://github.com/mcp360/unified-gateway-mcp
Owner: mcp360
Created: 2025-11-25T11:56:10.000Z (8 months ago)
Default Branch: main
Last Pushed: 2026-03-11T05:41:19.000Z (4 months ago)
Last Synced: 2026-03-11T11:46:23.994Z (4 months ago)
Topics: agent-tools, agentic-ai, ai-agents, claude, developer-tools, mcp, mcp360, model-context-protocol, no-code, workflow-automation
Language: TypeScript
Homepage: https://mcp360.ai
Size: 72.3 KB
Stars: 8
Watchers: 0
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# 🚀 MCP360 Universal Gateway

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)

[Get Started](#-quick-start) • [Features](#-key-features) • [Documentation](https://help.mcp360.ai/) • [Support](https://mcp360.ai)

---

## 🎯 What is MCP360?

**MCP360 is a unified MCP gateway** that gives AI agents access to **100+ external tools**, including prebuilt MCPs and custom MCP servers. You can connect your agents once and immediately run searches, research tasks, SEO workflows, and other operational actions. Instead of spending days integrating multiple APIs, connect to 100+ tools easily with a simple setup, or add your own **Custom MCPs** when you need specific logic or data.

---

## ✨ Key Features

Smart Discovery

_{Find the perfect tool across all connected MCP servers}

Universal Execution

_{Run any tool from any MCP server with a single command}

Enterprise Security

_{API key authentication with secure token handling}

Universal Access

_{Single gateway to marketplace MCPs and custom integrations}

Lightning Fast

_{Optimized for performance with global CDN delivery}

Universal Compatibility

_{Works with Claude Desktop, Cursor, Windsurf, VS Code & more}

---

## 🚀 Quick Start

### Step 1: Get Your API Key

1. **Sign up** at [mcp360.ai](https://mcp360.ai) 🎉
2. Navigate to **Settings → API Keys** ⚙️
3. Click **Generate New Key** 🔑
4. Copy your API key securely 📋

### Step 2: Choose Your Platform

🖥️ Claude Desktop (Click to expand)

**Configuration File Locations:**
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

**Add this configuration:**

```json
{
"mcpServers": {
"mcp360": {
"command": "npx",
"args": ["-y", "@mcp360/universal-gateway"],
"env": {
"MCP360_API_KEY": "your_api_key_here"
}
}
}
}
```

**Restart Claude Desktop** and you're ready! 🎊

🎯 Cursor

1. Open Cursor Settings: `Cmd/Ctrl + Shift + J`
2. Navigate to the **MCP** section
3. Add server configuration:

```json
{
"mcpServers": {
"mcp360": {
"command": "npx",
"args": ["-y", "@mcp360/universal-gateway"],
"env": {
"MCP360_API_KEY": "your_api_key_here"
}
}
}
}
```

**Restart Cursor** to activate! 🚀

💻 Claude Code

**Configuration File Locations:**
- **macOS/Linux:** `~/.config/claude-code/mcp_settings.json`
- **Windows:** `%APPDATA%\claude-code\mcp_settings.json`

**Add this configuration:**

```json
{
"mcpServers": {
"mcp360": {
"command": "npx",
"args": ["-y", "@mcp360/universal-gateway"],
"env": {
"MCP360_API_KEY": "your_api_key_here"
}
}
}
}
```

**Restart Claude Code** to load the gateway! ✨

🌊 Windsurf

**Configuration File Locations:**
- **macOS:** `~/Library/Application Support/Windsurf/mcp_config.json`
- **Windows:** `%APPDATA%\Windsurf\mcp_config.json`

**Add this configuration:**

```json
{
"mcpServers": {
"mcp360": {
"command": "npx",
"args": ["-y", "@mcp360/universal-gateway"],
"env": {
"MCP360_API_KEY": "your_api_key_here"
}
}
}
}
```

**Restart Windsurf** to activate! 🌟

🔧 VS Code (Cline Extension)

1. Install the [Cline extension](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev)
2. Open **Cline settings**
3. Add MCP server configuration:

```json
{
"mcpServers": {
"mcp360": {
"command": "npx",
"args": ["-y", "@mcp360/universal-gateway"],
"env": {
"MCP360_API_KEY": "your_api_key_here"
}
}
}
}
```

**Reload VS Code** to activate the gateway! 💡

🤖 YourGPT

1. Go to your **YourGPT Dashboard**
2. Select **Functions** from the sidebar
3. Choose the **MCP Server** option
4. You'll see two options:
- **Browse Marketplace MCP** - Select from pre-configured MCP servers
- **Add Custom MCP** - Add your own MCP server configuration

**Use MCP360 in YourGPT:**
- Select **Add MCP**
- Enter the server details:
- **Name:** `mcp360`
- **URL:** `https://connect.mcp360.ai/v1/mcp360/mcp?token=YOUR_API_KEY`

**Save and activate** to start using MCP360 in YourGPT! 🎉

### 🚄 Pro Tip: Global Installation

For **faster startup times**, install globally:

```bash
npm install -g @mcp360/universal-gateway
```

Then update your config to use the global command:

```json
{
"mcpServers": {
"mcp360": {
"command": "mcp360-gateway",
"env": {
"MCP360_API_KEY": "your_api_key_here"
}
}
}
}
```

---

## 🛠️ Core Tools

The gateway provides **2 powerful meta-tools** that unlock access to 100+ services:

### 1️⃣ `search` - Discover Available Tools

Find the perfect tool for your task across all connected MCP servers.

**Parameters:**
- `query` *(optional)*: Search term to filter by name or description

**Examples:**

```bash
💬 "Search for email tools"
💬 "Show me all available tools"
💬 "Find tools for SEO"
💬 "What tools can help with keyword research?"
```

**Returns:** Comprehensive list of matching tools with names, descriptions, and parameters.

---

### 2️⃣ `execute` - Run Any Tool

Execute any tool from any connected MCP server with dynamic parameters.

**Parameters:**
- `tool_name` *(required)*: Name of the tool to execute
- `arguments` *(optional)*: Tool-specific parameters as an object

**Examples:**

```bash
💬 "Execute verify_email with email 'test@example.com'"
💬 "Run keyword_research with keyword 'AI tools'"
💬 "Execute get_crypto_price for Bitcoin"
```

**Returns:** Tool-specific results tailored to your request.

---

## 🌟 Available Services

### 🏪 MCP360 Marketplace

| Service | Description | Use Cases |
|---------|-------------|-----------|
| 🔍 **Keyword Research** | SEO keyword analysis & search volumes | Content strategy, SEO optimization |
| 📊 **OnPage SEO Checker** | Website SEO element analysis | Site audits, optimization |
| ✉️ **Email Verification** | Validate email addresses | List cleaning, form validation |
| 🕷️ **Web Scraping** | Extract content from websites | Data collection, monitoring |
| 📈 **Google Trends** | Search trends & interest data | Market research, trending topics |
| 💰 **Cryptocurrency** | Real-time crypto prices & market data | Price tracking, portfolio management |

### 🔧 Your Custom MCPs

All custom MCP servers you've created in your MCP360 account are automatically available through the Universal Gateway!

---

## 📖 Typical Workflow

```mermaid
graph LR
A[🔍 Discover Tools] --> B[📋 Check Parameters]
B --> C[⚡ Execute Tool]
C --> D[📊 Get Results]
D --> E{Need More?}
E -->|Yes| A
E -->|No| F[✅ Done]
```

### Example Session

```bash
# Step 1: Discover
User: "Search for email tools"
→ Returns: verify_email, send_email, email_lookup, etc.

# Step 2: Check Details
→ See: verify_email requires { email: string }

# Step 3: Execute
User: "Execute verify_email with email 'john@example.com'"
→ Returns: { valid: true, deliverable: true, ... }
```

---

**How it works:**

1. 🔐 **Authenticate** with your API key
2. 🔄 **Aggregate** all available tools from marketplace and custom MCPs
3. 🎯 **Expose** them through 2 simple meta-tools: `search` and `execute`
4. ⚡ **Execute** tools dynamically based on your requests

---

## 🔧 Configuration

### Environment Variables

| Variable | Description | URL |
|----------|--------------|---------|
| `MCP360_TOOL_URL` | Your MCP360 API key | `https://connect.mcp360.ai/v1/mcp360/_tool_name_/mcp` |
| `MCP360_UNIVERSAL_GATEWAY` | Custom gateway URL | `https://connect.mcp360.ai/v1/mcp360/mcp` |

### Custom Gateway URL

For enterprise deployments or custom configurations:

```json
{
"mcpServers": {
"mcp360": {
"command": "npx",
"args": ["-y", "@mcp360/universal-gateway"],
"env": {
"MCP360_API_KEY": "your_api_key_here",
"MCP360_GATEWAY_URL": "https://your-custom-gateway.com/mcp"
}
}
}
}
```

## 🚀 Quick Start

### Step 1: Get Your API Key (Optional)

MCP360 supports **flexible authentication** to get you started quickly:

🔑 Option 1: Manual API Key Setup

1. **Sign up** at [mcp360.ai](https://mcp360.ai) 🎉
2. Navigate to **Settings → API Keys** ⚙️
3. Click **Generate New Key** 🔑
4. Copy your API key and add it to your configuration 📋

🔐 Option 2: Skip API Key - Use OAuth 2.0 (Automatic Fallback)

**No API key? No problem!** Simply connect MCP360 without an API key, and our OAuth 2.0 flow will automatically activate:

1. 🌐 Your browser opens to the MCP360 sign-in page
2. 🔓 You grant permission to access your MCP360 account
3. 📂 You select your project and API key
4. ✅ Authentication completes seamlessly

**Benefits:**
- ⚡ Zero manual API key management
- 🔄 Easy project switching
- 🔒 Secure token-based authentication
- 🎯 Granular permission control

> **Note:** If you don't provide an API key in your configuration, OAuth 2.0 authentication will trigger automatically on first use.

---

## 🔒 Enterprise-Grade Security

### 🛡️ Security Compliance & Certifications

MCP360 is built with enterprise security at its core, ensuring your data is protected with industry-leading standards.

GDPR

🇪🇺 GDPR Compliant

_{Full compliance with European data protection regulations}

^{✓ Data Privacy}

^{✓ User Consent}

^{✓ Right to Delete}

🔐 SOC 2 Type II

_{Rigorous security, availability, and confidentiality controls}

^{✓ Security Controls}

^{✓ Availability}

^{✓ Confidentiality}

🏆 ISO 27001

_{International standard for information security management}

^{✓ Risk Management}

^{✓ Asset Protection}

^{✓ Continuous Improvement}

### 🔑 Secure Authentication Options

| Method | Security Level | Best For |
|--------|----------------|----------|
| **OAuth 2.0** | 🔒🔒🔒 Highest | Production environments, team access |
| **API Key** | 🔒🔒 High | Development, personal projects |

**Security Features:**
- 🔐 **Encrypted Communication**: All data transmitted over TLS 1.3
- 🔄 **Token Rotation**: Automatic OAuth token refresh
- 📊 **Audit Logs**: Complete activity tracking
- 🚫 **Rate Limiting**: Protection against abuse
- 🛡️ **DDoS Protection**: Enterprise-grade infrastructure
- 🔍 **Anomaly Detection**: AI-powered security monitoring

---

## 📚 Resources
Learn how to set up, test, and manage MCP servers and functions using MCP360:

_{🚀 MCP360 Integration}

_{Step-by-step installation, configuration, and your first tool execution. Perfect for beginners!}

_{⚡ Advanced Capabilities}

_{Deep dive into powerful features, custom MCPs, and advanced workflows for power users.}

### 📖 Additional Learning Resources

Help Center

_{Comprehensive guides, API references, and best practices}

Dev.to Tutorial

_{Build an Amazon Price Alert system with n8n integration}

Code Examples

_{Ready-to-use code snippets and integration samples}

---

## 💬 Support & Community

GitHub Issues

🐛 Bug Reports & Features

_{Report bugs, request features}

^{Issue Tracking • Feature Requests}

Email Support

📧 Direct Support

_{Assistance from our support team}

^{24-hr Response • Priority Support}

## 📄 License

This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.

---

## 🙏 Acknowledgments

Built with ❤️ by the team at [MCP360](https://mcp360.ai)

Special thanks to:
- 🌟 All our contributors
- 💡 The Anthropic team for Claude Desktop
- 🚀 The open-source community

---

### 🌟 Star Us on GitHub!

If you find MCP360 Universal Gateway helpful, please consider giving us a star ⭐

[![GitHub stars](https://img.shields.io/github/stars/mcp360/universal-gateway?style=social)](https://github.com/mcp360/universal-gateway)

**Made with ❤️ by [MCP360](https://mcp360.ai)**

[Website](https://mcp360.ai) • [Documentation](https://help.mcp360.ai/) • [GitHub](https://github.com/mcp360/universal-gateway) • [npm](https://www.npmjs.com/package/@mcp360/universal-gateway)