POST /api/mcp/remove Bearer

Remove MCP Server

Remove an MCP server configuration from PocketPaw. If the server is currently running, it will be stopped before removal. The server's tools become unavailable immediately.

Overview

Removes an MCP server from the configuration. If the server is currently running, it will be stopped first.

Request Body

Body Parameters

name required
string

The name of the MCP server to remove.

Response

status string
"ok" on success
Terminal window
curl -X POST "http://localhost:8000/api/mcp/remove" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"name": "filesystem"}'
const response = await fetch("http://localhost:8000/api/mcp/remove", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({ name: "filesystem" })
});
const data = await response.json();
console.log(data);
import requests
response = requests.post(
"http://localhost:8000/api/mcp/remove",
headers={"Authorization": "Bearer <token>"},
json={"name": "filesystem"}
)
print(response.json())
{ "status": "ok" }
{ "detail": "Server not found in configuration" }
Request
curl -X POST "http://localhost:8000/api/mcp/remove" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>"
const response = await fetch("http://localhost:8000/api/mcp/remove", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
},
});

const data = await response.json();
console.log(data);
import requests

response = requests.post(
    "http://localhost:8000/api/mcp/remove",
    headers={'Content-Type':'application/json','Authorization':'Bearer <token>'},
)

print(response.json())
package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("POST", "http://localhost:8000/api/mcp/remove", nil)
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer <token>")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}
Response
Send a request to see the response