agent

Overview

1MCP addresses MCP configuration sprawl by providing a unified runtime that can aggregate multiple MCP servers behind a single endpoint. It offers multiple modes of operation including CLI mode for progressive discovery, stdio proxy for maximum compatibility, and direct HTTP attachment for native MCP clients. The implementation supports static servers loaded at startup and template servers resolved from client context, with features like async loading, instruction aggregation, and preset filtering. This makes it ideal for managing complex MCP setups across different AI agents while maintaining a consistent runtime experience.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• instructions

  Get current runtime instructions and recommended workflow

  Try:Show me the current instructionsTry:What should I do next?
• inspect

  Discover servers or tools in the runtime

  Try:Inspect the context7 serverTry:Show me all available tools
• run

  Execute a specific tool with arguments

  Try:Run context7 query with MongoDB aggregation pipelineTry:Execute tool with JSON arguments
• query-docs

  Query documentation from a library

  Try:Search MongoDB docs for aggregation pipelineTry:Find information about a specific library
• proxy

  Start a stdio proxy for maximum client compatibility

  Try:Start a proxy connectionTry:Connect via stdio proxy
• mcp

  Manage MCP servers and connections

  Try:Add a new MCP serverTry:Configure MCP connection

Note: Tool names extracted from CLI examples and documentation. This appears to be a meta-server that aggregates other MCP servers rather than exposing its own tools directly.

Comparable tools

Installation

npm install -g @1mcp/agent

1mcp mcp add context7 -- npx -y @upstash/context7-mcp

1mcp serve

{
  "mcpServers": {
    "1mcp": {
      "url": "http://127.0.0.1:3050/mcp?app=claude-code"
    }
  }
}

FAQ

What's the difference between CLI mode and stdio proxy mode?

CLI mode is designed for agent-style sessions with progressive discovery using 'instructions -> inspect -> run'. Stdio proxy mode offers broader client compatibility while maintaining project context through .1mcprc configuration.

How does 1MCP handle authentication?

1MCP supports authentication at the runtime level, with centralized auth configuration that applies to all aggregated MCP servers. See the authentication documentation for setup details.

Compare agent with