Unified Gateway

Shared resource

A single point of connection for all your tools. Reduce complexity and improve performance by loading tool contexts only when they are needed.

01 — Overview

The Unified Gateway is an open-source solution that solves a critical problem for large-scale AI collaboration: traditional setups load all tool definitions at once, consuming thousands of tokens before any work begins.

By acting as an intelligent proxy, the gateway only exposes core capabilities initially. Detailed tool context is loaded on-demand, reducing initial overhead by more than 90%.

02 — Core Benefits

Token Efficiency

Instead of overwhelming your assistants with thousands of tool descriptions, the gateway provides a clean initial state. Resources are requested progressively as the task requires.

Centralized Control

Connect multiple sources of knowledge and automation through a single endpoint. Replace fragmented configurations with one unified board.

Capability Filtering

Define which tools are available for different tasks or team roles. Maintain strict control over what your AI assistants can access and execute.

Flexible Setup

Support for both local and remote connection protocols. Mix and match tool sources while maintaining a consistent interface for your AI team.

03 — Core Capabilities

describe_tools

Retrieve information about available capabilities from all connected sources. Supports focused filtering by source name or task type.

List all sources
Filter by capability
Get detailed schemas

use_tool

Execute any discovered capability through the gateway. Includes automatic routing to the correct source and validation of arguments.

Standardized execution
Automatic routing
Structured results

04 — Setup

Quick start

Initialize the gateway configuration in your local project:

npx @agiflowai/one-mcp init

Environment configuration

Add this to your AI assistant's connection settings:

{
  "mcpServers": {
    "gateway": {
      "command": "npx",
      "args": [
        "-y",
        "@agiflowai/one-mcp",
        "mcp-serve",
        "--config",
        "./mcp-config.yaml"
      ]
    }
  }
}

Source definitions

Define your knowledge sources in a central configuration file:

mcpServers:
  # Local file system
  filesystem:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-filesystem", "${HOME}/Documents"]
    config:
      instruction: "Secure file access"
      toolBlacklist:
        - write_file
        - delete_file

  # Remote company tools
  company-tools:
    url: "https://mcp.company.com/sse"
    transport: sse
    config:
      omitToolDescription: true

  # Experimental features (disabled)
  experimental:
    command: npx
    args: ["-y", "experimental-tools"]
    disabled: true

05 // Terminal Commands

mcp-serve

Start the gateway server for local or remote connections.

init

Initialize a new configuration file in your directory.

list-tools

Display all capabilities currently shared through the gateway.

describe-tools

Get detailed information about specific capabilities.

use-tool

Execute a capability directly from your terminal.

Next Steps

Standardization

Learn how to generate consistent results using shared templates for your projects.

View module

View Source

Explore the source code, contribute, or report issues on GitHub.

GitHub