How do I use mcpwrapped?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcpwrapped list the tools that are currently whitelisted" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcpwrapped

coverage npm downloads

mcpwrapped is a lightweight MCP (Model Context Protocol) proxy that sits between an MCP client and server. It allows you to filter available tools, preventing context window clutter by only exposing the tools you explicitly want to use.

Features

Tool Filtering: Whitelist specific tools using the --visible_tools flag
Transparent Proxy: Forwards all other MCP protocol messages (resources, prompts, etc.) unchanged
Easy Integration: Works with any MCP client that supports command-based server configuration

Installation

npm install -g mcpwrapped

Usage

mcpwrapped wraps your existing MCP server command. You pass the filtering flags first, followed by the actual command to run the server.

Basic Syntax

mcpwrapped --visible_tools=tool1,tool2 <actual_command> [actual_args...]

Example: Claude Desktop Configuration

To use it with Claude Desktop, update your claude_desktop_config.json:

{ "mcpServers": { "filesystem": { "command": "mcpwrapped", "args": [ "--visible_tools=read_file", "npx", "-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Desktop" ] } } }

In this example, only the read_file tool from the filesystem server would be visible to Claude, hiding write_file, list_directory, etc.

Configuration Flags

Flag	Description	Example
‑‑visible_tools	Comma-separated list of tool names to expose	‑‑visible_tools=read,write

How It Works

┌─────────────┐ ┌──────────────┐ ┌─────────────┐ │ MCP Client │ ◀──────▶│ mcpwrapped │ ◀──────▶│ MCP Server │ │ (Claude) │ │ (Proxy) │ │ │ │ │ │ │ │ │ └─────────────┘ └──────────────┘ └─────────────┘ │ └── Filters tool_list to only include tools specified in --visible_tools

mcpwrapped acts as a transparent proxy that:

Spawns the actual MCP server with the provided command
Intercepts messages from the server
Filters the tools list in initialization messages to only include allowed tools
Passes through all other messages unchanged (resources, prompts, tool calls, etc.)