unified-gateway

MCP360 Universal Gateway acts as a centralized access point to a large collection of MCP servers and tools. Once configured with your API key, it enables smart discovery and universal execution across all connected services, allowing AI agents to search for the most suitable tool and run operations from any MCP server through a single gateway. Two core meta-tools are exposed: search for discovering available tools across the marketplace and connected custom MCPs, and execute for running any chosen tool with its required parameters. This setup streamlines workflows such as SEO research, data scraping, email verification, and more by consolidating access behind one gateway rather than wiring multiple APIs. To use it, configure the gateway in your environment (or install globally) and point your client or agent to the gateway through your preferred MCP interfaces, providing your API key for authentication. You can also leverage the optional global installation to speed up startup times and then reference the gateway by a shorter command name.

Prerequisites:

• Node.js v18 or newer
• npm (comes with Node.js)

Installation steps:

1. Install the gateway globally (recommended for faster startup):

npm install -g @mcp360/universal-gateway

2. Configure your MCP gateway in your client apps or agents by referencing the global command as shown:

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

3. Alternatively, run via npx without global install (as described in the repository):

npx -y @mcp360/universal-gateway

4. If you prefer local usage, install in your project and invoke via node/npm scripts as needed.

Prereqs and notes:

• Obtain an MCP360 API key from your account settings.
• The MCP360_API_KEY must be provided to authenticate requests through the gateway.

Tips and caveats:

• API key: Always keep MCP360_API_KEY secure and do not expose it in client-side code.
• If you install globally, you can simplify your config by using command mcp360-gateway in the mcpServers config.
• The gateway exposes two main tools, search and execute, to discover tools and run any tool from any connected MCP server.
• You can integrate the gateway with various clients (Claude Desktop, Cursor, Windsurf, Claude Code, VS Code, YourGPT) by adding the mcp360 configuration blocks shown in the README to each platform's config file.
• If you encounter connectivity or authentication issues, verify your API key, ensure the gateway process has network access, and check that the target MCP server(s) are online and accessible.
• You can expand the setup by adding more MCP servers or using custom configurations as needed; the config format supports multiple servers under mcpServers.
• Environment variables can be extended with additional options as required by your deployment environment.