Skip to main content
PATCH
/
wp-json
/
getmcp
/
v1
/
servers
/
{id}
curl --request PATCH \
     --url https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0 \
     --header 'Authorization: Bearer gmcp_your_api_key' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "GitHub Tools v2",
  "description": "Updated tools for GitHub",
  "auth_type": "bearer",
  "test_auth_credentials": "{\"token\":\"your_bearer_token\"}",
  "rate_limit_per_min": 60
}
'

{
  "id": 3,
  "uuid": "9a3b7c8d-2e1f-4a5b-8c9d-0e1f2a3b4c5d",
  "user_id": 1,
  "name": "GitHub Tools v2",
  "slug": "github-tools",
  "server_id": "c3d4e5f6a1b2c3d4",
  "status": "active",
  "transport_type": "streamable-http",
  "auth_type": "bearer",
  "auth_config": null,
  "outbound_auth_type": "none",
  "outbound_auth_config": null,
  "cors_origins": null,
  "rate_limit_per_min": 60,
  "settings": {
    "description": "Updated tools for GitHub"
  },
  "endpoint_url": "https://yoursite.com/mcp/github-tools",
  "tool_count": 5,
  "prompt_count": 0,
  "resource_count": 0,
  "created_at": "2025-03-18T10:00:00Z",
  "updated_at": "2025-03-18T11:30:00Z"
}

​
Path Parameters

​
id
string
required
The UUID of the server to update (e.g. 836995ae-1cff-41ec-823e-a4f07ccca3a0). Numeric IDs are also accepted for backwards compatibility.

​
Body Parameters

All fields are optional. Only include fields you want to update.
​
name
string
New server name.
​
description
string
Server description. Merged into settings.description — other settings fields are preserved.
​
status
string
Server status. One of: active, paused, draft.
​
auth_type
string
Inbound authentication required for the MCP endpoint. One of: none, bearer, api-key, basic, oauth.
​
test_auth_credentials
string
JSON-encoded string of the credentials used when clicking Test in the admin panel. Stored encrypted; never exposed to MCP clients. Falls back to auth_credentials if not set.Format depends on test_auth_type:Bearer — {"token":"your_bearer_token"}API Key — {"name":"X-API-Key","value":"your_api_key","location":"header"} — use "location":"query" for query param.Basic Auth — {"username":"your_username","password":"your_password"}
Pass as a JSON-serialised string here. The GET /servers/{id}/credentials endpoint returns these as a decoded object.
​
cors_origins
string
Comma-separated allowed CORS origins. Leave empty to allow all origins (*).
​
rate_limit_per_min
integer
New rate limit per minute.
curl --request PATCH \
     --url https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0 \
     --header 'Authorization: Bearer gmcp_your_api_key' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "GitHub Tools v2",
  "description": "Updated tools for GitHub",
  "auth_type": "bearer",
  "test_auth_credentials": "{\"token\":\"your_bearer_token\"}",
  "rate_limit_per_min": 60
}
'

{
  "id": 3,
  "uuid": "9a3b7c8d-2e1f-4a5b-8c9d-0e1f2a3b4c5d",
  "user_id": 1,
  "name": "GitHub Tools v2",
  "slug": "github-tools",
  "server_id": "c3d4e5f6a1b2c3d4",
  "status": "active",
  "transport_type": "streamable-http",
  "auth_type": "bearer",
  "auth_config": null,
  "outbound_auth_type": "none",
  "outbound_auth_config": null,
  "cors_origins": null,
  "rate_limit_per_min": 60,
  "settings": {
    "description": "Updated tools for GitHub"
  },
  "endpoint_url": "https://yoursite.com/mcp/github-tools",
  "tool_count": 5,
  "prompt_count": 0,
  "resource_count": 0,
  "created_at": "2025-03-18T10:00:00Z",
  "updated_at": "2025-03-18T11:30:00Z"
}