A utility to manage Windsurf MCP server configurations
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-configuration-manager","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Windsurf MCP Config Manager A command-line utility to manage Windsurf/Codeium MCP server configurations. This tool helps you easily add, update, delete, and list MCP server configurations used by Windsurf/Codeium. ## Installation ```bash pip install windsurf-mcp-config-manager ``` ## Quick Start The utility provides a command-line interface with the shortcut `wmcp` and several subcommands: ```bash # Add a new MCP server wmcp add my-server --command python --args "server.py,--port=8080" --env DEBUG=true # List all configured servers wmcp list # Update an existing server wmcp update my-server --command node --args "app.js,--env=production" # Delete a server wmcp delete my-server ``` ## Configuration File By default, the configuration is stored in `~/.codeium/windsurf/mcp_config.json`. The file is automatically created if it doesn't exist. A backup is always created before making any changes to the configuration file. ## Detailed Usage ### Global Options ``` --config TEXT Path to the config file (default: ~/.codeium/windsurf/mcp_config.json) --help Show this message and exit ``` ### Add Command Add a new MCP server configuration. ```bash wmcp add NAME --command COMMAND [--args ARGS] [--env KEY=VALUE] ``` Options: - `NAME`: Name of the MCP server (required) - `--command TEXT`: Command to run the MCP server (required) - `--args TEXT`: Arguments for the command (comma-separated) - `--env TEXT`: Environment variables in KEY=VALUE format (can be specified multiple times) Example: ```bash wmcp add my-server --command python --args "server.py,--port=8080,--debug" --env DEBUG=true --env LOG_LEVEL=info ``` ### Delete Command Delete an MCP server configuration. ```bash wmcp delete NAME ``` Options: - `NAME`: Name of the MCP server to delete (required) Example: ```bash wmcp delete my-server ``` ### Update Command Update an existing MCP server configuration. ```bash wmcp update NAME [--command COMMAND] [--args ARGS] [--env KEY=VALUE] ``` Opt…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.