Skip to content

mcp360/unified-gateway-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ MCP360 Universal Gateway

License: MIT Node.js Version

Get Started β€’ Features β€’ Documentation β€’ Support


🎯 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
Smart Discovery
Find the perfect tool across all connected MCP servers
Universal Execution
Universal Execution
Run any tool from any MCP server with a single command
Enterprise Security
Enterprise Security
API key authentication with secure token handling
Universal Access
Universal Access
Single gateway to marketplace MCPs and custom integrations
Lightning Fast
Lightning Fast
Optimized for performance with global CDN delivery
Universal Compatibility
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 πŸŽ‰
  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:

{
  "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:
{
  "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:

{
  "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:

{
  "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
  2. Open Cline settings
  3. Add MCP server configuration:
{
  "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:

npm install -g @mcp360/universal-gateway

Then update your config to use the global command:

{
  "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:

πŸ’¬ "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:

πŸ’¬ "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

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

Example Session

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

{
  "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 πŸŽ‰
  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

πŸ” SOC 2 Type II

Rigorous security, availability, and confidentiality controls

βœ“ Security Controls
βœ“ Availability
βœ“ Confidentiality
ISO 27001

πŸ† 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:


Complete Setup Walkthrough

Watch Tutorial

πŸš€ MCP360 Integration
Step-by-step installation, configuration, and your first tool execution. Perfect for beginners!
Advanced Features Deep Dive

Watch Advanced Tutorial

⚑ Advanced Capabilities
Deep dive into powerful features, custom MCPs, and advanced workflows for power users.

πŸ“– Additional Learning Resources

Documentation

Documentation

Help Center
Comprehensive guides, API references, and best practices
Tutorial

Dev.to Tutorial

Dev.to Tutorial
Build an Amazon Price Alert system with n8n integration
Examples

Examples

Code Examples
Ready-to-use code snippets and integration samples

πŸ’¬ Support & Community

GitHub Issues

GitHub Issues

πŸ› Bug Reports & Features
Report bugs, request features

Issue Tracking β€’ Feature Requests
Email Support

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 file for details.


πŸ™ Acknowledgments

Built with ❀️ by the team at MCP360

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

Made with ❀️ by MCP360

Website β€’ Documentation β€’ GitHub β€’ npm