mcp-funnel — Claude Code MCP server: features and setup
mcp-funnel brings multiple MCP servers behind one proxy and lets you filter and customize their tools. Use it to manage tools from several servers through a single connection.
claude mcp add --env MCP_FUNNEL_CONFIG=<MCP_FUNNEL_CONFIG> --transport stdio mcp -- npx -y mcp-funnelWhat mcp-funnel does
mcp-funnel acts as a proxy for multiple MCP servers. It lets you filter and customize the tools they expose, bringing those tools under one interface.
To add it to Claude Code, run claude mcp add mcp-funnel -- npx -y mcp-funnel. A separate command supports a configuration value through MCP_FUNNEL_CONFIG; replace <MCP_FUNNEL_CONFIG> with that value. The configuration command needs the value to be supplied.
What it helps with
- combine several MCP servers behind one proxy
- filter which server tools an agent can access
- customize tools exposed by multiple MCP servers
Example prompts for the agent
- Use the tools from the connected MCP servers through mcp-funnel.
- Filter the MCP server tools available for this task.
- Route access to several MCP servers' tools through mcp-funnel.
How to install mcp-funnel
Platform CLI
claude mcp add --env MCP_FUNNEL_CONFIG=<MCP_FUNNEL_CONFIG> --transport stdio mcp -- npx -y mcp-funnelReplace <…> with your own values
Platform CLI
codex mcp add mcp --env MCP_FUNNEL_CONFIG=<MCP_FUNNEL_CONFIG> -- npx -y mcp-funnelReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"mcp-funnel"
],
"env": {
"MCP_FUNNEL_CONFIG": "<MCP_FUNNEL_CONFIG>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-funnel"
],
"env": {
"MCP_FUNNEL_CONFIG": "<MCP_FUNNEL_CONFIG>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MCP_FUNNEL_CONFIG=<MCP_FUNNEL_CONFIG> mcp npx -y mcp-funnelReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-funnel
How do I install mcp-funnel in Claude Code?
Run claude mcp add mcp-funnel -- npx -y mcp-funnel.
What does mcp-funnel do?
It proxies multiple MCP servers and lets you filter and customize their tools.
How do I start mcp-funnel with a configuration value?
Run claude mcp add --env MCP_FUNNEL_CONFIG=<MCP_FUNNEL_CONFIG> --transport stdio mcp -- npx -y mcp-funnel, replacing the placeholder with your configuration value.
