<div align="center">

# 🚀 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)

</div>

---

## 🎯 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

<table align="center"> 
  <tr> 
    <td align="center" width="30%"> 
      <img src="https://img.icons8.com/fluency/96/search.png" width="40" alt="Smart Discovery"/> 
      <br/> 
      <strong>Smart Discovery</strong> 
      <br/> 
      <sub>Find the perfect tool across all connected MCP servers</sub> 
    </td> 
    <td align="center" width="30%"> 
      <img src="https://img.icons8.com/fluency/96/lightning-bolt.png" width="40" alt="Universal Execution"/> 
      <br/> 
      <strong>Universal Execution</strong> 
      <br/> 
      <sub>Run any tool from any MCP server with a single command</sub> 
    </td> 
    <td align="center" width="30%"> 
      <img src="https://img.icons8.com/fluency/96/lock.png" width="40" alt="Enterprise Security"/> 
      <br/> 
      <strong>Enterprise Security</strong> 
      <br/> 
      <sub>API key authentication with secure token handling</sub> 
    </td> 
  </tr> 
  <tr> 
    <td align="center" width="30%"> 
      <img src="https://img.icons8.com/fluency/96/internet.png" width="40" alt="Universal Access"/> 
      <br/> 
      <strong>Universal Access</strong> 
      <br/> 
      <sub>Single gateway to marketplace MCPs and custom integrations</sub> 
    </td> 
    <td align="center" width="30%"> 
      <img src="https://img.icons8.com/fluency/96/rocket.png" width="40" alt="Lightning Fast"/> 
      <br/> 
      <strong>Lightning Fast</strong> 
      <br/> 
      <sub>Optimized for performance with global CDN delivery</sub> 
    </td> 
    <td align="center" width="30%"> 
      <img src="https://img.icons8.com/fluency/96/puzzle.png" width="40" alt="Universal Compatibility"/> 
      <br/> 
      <strong>Universal Compatibility</strong> 
      <br/> 
      <sub>Works with Claude Desktop, Cursor, Windsurf, VS Code & more</sub> 
    </td> 
  </tr> 
</table>

---

## 🚀 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

<details open>
<summary><b>🖥️ Claude Desktop</b> (Click to expand)</summary>

<br>

**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! 🎊

</details>

<details>
<summary><b>🎯 Cursor</b></summary>

<br>

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! 🚀

</details>

<details>
<summary><b>💻 Claude Code</b></summary>

<br>

**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! ✨

</details>

<details>
<summary><b>🌊 Windsurf</b></summary>

<br>

**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! 🌟

</details>

<details>
<summary><b>🔧 VS Code (Cline Extension)</b></summary>

<br>

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! 💡

</details>

<details>
<summary><b>🤖 YourGPT</b></summary>
<br>

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! 🎉

</details>

<details>
<summary><b>🦀 OpenClaw</b></summary>

<br>

OpenClaw is an open-source, self-hosted agent runtime that treats AI agents as long-lived managed processes with state, health, tooling, and execution boundaries. MCP360 connects to OpenClaw as a unified tool gateway.

**Step 1: Install OpenClaw globally**

```bash
npm i -g openclaw

openclaw --version
```

**Step 2: Run initial configuration**

```bash
openclaw configure
```

**Step 3: Start the gateway and verify health**

```bash
openclaw gateway

openclaw gateway status

openclaw doctor
```

> All health checks must pass before proceeding.

**Step 4: Install MCP tooling for inspection**

```bash
npm i -g mcporter

mcporter --version
```

**Step 5: Create a stable MCP configuration directory**

```bash
mkdir -p ~/mcp

cd ~/mcp
```

**Step 6: Register MCP360 as an MCP server**

```bash
mcporter config add mcp360 \
--command 'npx mcp-remote "https://connect.mcp360.ai/v1/mcp360/mcp?token=YOUR_API_KEY"'
```

**Step 7: Confirm registration and verify tool access**

```bash
mcporter config list

mcporter list
```

If `mcporter list` returns structured tool definitions, your MCP360 connection is working correctly. ✅

> **Tip:** Use `openclaw tui` to run OpenClaw in the terminal instead of the dashboard.

📖 For a full walkthrough, see the [OpenClaw + MCP360 setup guide](https://mcp360.ai/blog/openclaw-agent-runtime-mcp-tool-setup).

</details>

### 🚄 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

<div align="center">

### 🏪 MCP360 Marketplace

</div>

| 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 |

<div align="center">

### 🔧 Your Custom MCPs

</div>

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:

<details open>
<summary><b>🔑 Option 1: Manual API Key Setup</b></summary>

<br>

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 📋

</details>

<details>
<summary><b>🔐 Option 2: Skip API Key - Use OAuth 2.0 (Automatic Fallback)</b></summary>

<br>

**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.

</details>

---

## 🔒 Enterprise-Grade Security

<div align="center">

### 🛡️ Security Compliance & Certifications

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

</div>

<table align="center">
  <tr>
    <td align="center" width="33%">
      <img src="https://martech.org/wp-content/uploads/2018/09/GDPR-with-stars_wkhip8-600x338.png" width="60" alt="GDPR"/>
      <br><br>
      <b>🇪🇺 GDPR Compliant</b>
      <br><br>
      <sub>Full compliance with European data protection regulations</sub>
      <br><br>
      <sup>✓ Data Privacy</sup><br>
      <sup>✓ User Consent</sup><br>
      <sup>✓ Right to Delete</sup>
    </td>
    <td align="center" width="33%">
      <img src="https://swimlane.com/assets/uploads/images/AICPA-Logo.png" width="60" alt="SOC 2"/>
      <br><br>
      <b>🔐 SOC 2 Type II</b>
      <br><br>
      <sub>Rigorous security, availability, and confidentiality controls</sub>
      <br><br>
      <sup>✓ Security Controls</sup><br>
      <sup>✓ Availability</sup><br>
      <sup>✓ Confidentiality</sup>
    </td>
    <td align="center" width="33%">
      <img src="https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRMxnxol4MpHV9-HWuVp5mLxWWU67dFZ5PXBg&s" width="60" alt="ISO 27001"/>
      <br><br>
      <b>🏆 ISO 27001</b>
      <br><br>
      <sub>International standard for information security management</sub>
      <br><br>
      <sup>✓ Risk Management</sup><br>
      <sup>✓ Asset Protection</sup><br>
      <sup>✓ Continuous Improvement</sup>
    </td>
  </tr>
</table>

<br>

<div align="center">

### 🔑 Secure Authentication Options

</div>

| 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:
<div align="center">

 

</div>

<br>

<table align="center">
  <tr>
    <td align="center" width="50%">
      <a href="https://youtu.be/_ATqVSwubW4?si=KizJaFigHOcWgiag">
        <img src="https://img.youtube.com/vi/_ATqVSwubW4/maxresdefault.jpg" alt="MCP360 Integration with N8N" width="100%" style="border-radius: 8px; box-shadow: 0 4px 6px rgba(0,0,0,0.1);"/>
      </a>
      <br><br>
      <a href="https://youtu.be/_ATqVSwubW4?si=KizJaFigHOcWgiag">
        <img src="https://img.shields.io/badge/Watch-MCP360_Integration_with_N8N-FF0000?style=for-the-badge&logo=youtube&logoColor=white" alt="MCP360 Integration with N8N"/>
      </a>
      <br><br>
      <sub><b>🚀 MCP360 Integration with N8N</b></sub>
      <br>
      <sub>Step-by-step installation, configuration, and your first tool execution. Perfect for beginners!</sub>
      <br>
    </td>
    <td align="center" width="50%">
      <a href="https://youtu.be/7y8lzoaI_04?si=kixfcGBro7VN4itl">
        <img src="https://img.youtube.com/vi/7y8lzoaI_04/maxresdefault.jpg" alt="Building Real MCP Workflows" width="100%" style="border-radius: 8px; box-shadow: 0 4px 6px rgba(0,0,0,0.1);"/>
      </a>
      <br><br>
      <a href="https://youtu.be/7y8lzoaI_04?si=kixfcGBro7VN4itl">
        <img src="https://img.shields.io/badge/Watch-Building_Real_MCP_Workflows-FF0000?style=for-the-badge&logo=youtube&logoColor=white" alt="Building Real MCP Workflows"/>
      </a>
      <br><br>
      <sub><b>⚡ Building Real MCP Workflows</b></sub>
      <br>
      <sub>Deep dive into powerful features, custom MCPs, and advanced workflows for power users.</sub>
      <br>
    </td>
  </tr>
</table>

<br>

<div align="center">

### 📖 Additional Learning Resources

</div>

<table align="center">
  <tr>
    <td align="center" width="33%">
      <a href="https://help.mcp360.ai/">
        <img src="https://img.icons8.com/fluency/96/book.png" width="60" alt="Documentation"/>
      </a>
      <br><br>
      <a href="https://help.mcp360.ai/">
        <img src="https://img.shields.io/badge/📚_Read-Documentation-4A90E2?style=for-the-badge" alt="Documentation"/>
      </a>
      <br><br>
      <b>Help Center</b>
      <br>
      <sub>Comprehensive guides, API references, and best practices</sub>
    </td>
    <td align="center" width="33%">
      <a href="https://dev.to/ankur_saini_15d4f46b01601/i-built-a-smart-amazon-price-drop-alert-using-n8n-1l44">
        <img src="https://img.icons8.com/fluency/96/code.png" width="60" alt="Tutorial"/>
      </a>
      <br><br>
      <a href="https://dev.to/ankur_saini_15d4f46b01601/i-built-a-smart-amazon-price-drop-alert-using-n8n-1l44">
        <img src="https://img.shields.io/badge/💻_Read-Tutorial-000000?style=for-the-badge&logo=dev.to&logoColor=white" alt="Dev.to Tutorial"/>
      </a>
      <br><br>
      <b>Dev.to Tutorial</b>
      <br>
      <sub>Build an Amazon Price Alert system with n8n integration</sub>
    </td>
    <td align="center" width="33%">
      <a href="https://github.com/mcp360/universal-gateway/tree/main/examples">
        <img src="https://img.icons8.com/fluency/96/repository.png" width="60" alt="Examples"/>
      </a>
      <br><br>
      <a href="https://github.com/mcp360/universal-gateway/tree/main/examples">
        <img src="https://img.shields.io/badge/📁_Browse-Code_Examples-181717?style=for-the-badge&logo=github&logoColor=white" alt="Examples"/>
      </a>
      <br><br>
      <b>Code Examples</b>
      <br>
      <sub>Ready-to-use code snippets and integration samples</sub>
    </td>
  </tr>
</table>

---

## 💬 Support & Community

<div align="center">

</div>



<table align="center" width="100%" cellspacing="0" cellpadding="0">
  <tr>
    <td align="center" width="50%" valign="top" style="padding: 20px;">
      <img src="https://img.icons8.com/fluency/96/github.png" width="70" alt="GitHub Issues"/>
      <br><br>
      <a href="https://github.com/mcp360/universal-gateway/issues">
        <img src="https://img.shields.io/badge/Report-GitHub_Issues-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub Issues"/>
      </a>
      <br><br>
      <b>🐛 Bug Reports & Features</b>
      <br>
      <sub>Report bugs, request features</sub>
      <br><br>
      <sup><b>Issue Tracking</b> • <b>Feature Requests</b></sup>
    </td>
    <td align="center" width="50%" valign="top" style="padding: 20px;">
      <img src="https://img.icons8.com/fluency/96/email-open.png" width="70" alt="Email Support"/>
      <br><br>
      <a href="mailto:support@mcp360.ai">
        <img src="https://img.shields.io/badge/Email-Direct_Support-EA4335?style=for-the-badge&logo=gmail&logoColor=white" alt="Email Support"/>
      </a>
      <br><br>
      <b>📧 Direct Support</b>
      <br>
      <sub>Assistance from our support team</sub>
      <br><br>
      <sup><b>24-hr Response</b> • <b>Priority Support</b></sup>
    </td>
  </tr>
</table>



<br>



## 📄 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

---

<div align="center">

### 🌟 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)

</div>