Remove an MCP server from your Claude Code configuration. Use this to uninstall an MCP server, delete an MCP server, remove a tool server, or clean up unused MCP servers.

Delete MCP Server

Name: delete
Author: sanjibdevnathlabs

Remove an MCP server from the Claude Code configuration.

Config File Locations (Claude Code only)

Global servers are stored in ~/.claude.json (NOT ~/.cursor/mcp.json).
Project servers are defined in .mcp.json at the project root.

Instructions

Check if the MCP Manager server is running:

curl -s --max-time 2 http://localhost:4111/api/health

If the server is NOT running, start it:

cd "$CLAUDE_PLUGIN_ROOT" && nohup node server/index.js > ~/.mcp-manager.log 2>&1 &
sleep 2

If the user did not specify which server to delete, list available servers first:
```
curl -s http://localhost:4111/api/config
```
Then ask the user which server they want to remove.
Confirm with the user before deleting. This action removes the server configuration permanently.
Delete the specified server:
```
curl -s -X DELETE http://localhost:4111/api/servers \
  -H "Content-Type: application/json" \
  -d '{"name": "<SERVER_NAME>", "scope": "<SCOPE>"}'
```
- name: the MCP server name
- scope: use "global" for global servers, or the full absolute workspace path (e.g., "/Users/me/my-project") for project servers. Do NOT use the string "project". Check the server's scope field from the /api/config response.
Confirm the deletion was successful. Mention which file was modified:
- Global: removed from ~/.claude.json
- Project: removed from .mcp.json in the project root
Remind the user to restart their Claude Code session.