Skip to main content
PATCH
/
wp-json
/
getmcp
/
v1
/
servers
/
{server_id}
/
tools
/
{id}
curl --request PATCH \
     --url https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools/5376af81-6bb8-4b01-800c-508d7672e394 \
     --header 'Authorization: Bearer gmcp_your_api_key' \
     --header 'content-type: application/json' \
     --data '
{
  "description": "Create a new customer in Stripe with metadata support",
  "timeout": 15,
  "retry_count": 2,
  "status": "active"
}
'

{
  "id": 5,
  "uuid": "5376af81-6bb8-4b01-800c-508d7672e394",
  "server_id": 1,
  "name": "create_customer",
  "description": "Create a new customer in Stripe with metadata support",
  "endpoint_url": "https://api.stripe.com/v1/customers",
  "http_method": "POST",
  "input_schema": {
    "type": "object",
    "properties": {
      "email": {"type": "string"},
      "name": {"type": "string"}
    },
    "required": ["email"]
  },
  "parameter_mapping": {
    "email": {"target": "body", "key": "email"},
    "name": {"target": "body", "key": "name"}
  },
  "response_mapping": {
    "selector": "",
    "format": "json",
    "template": ""
  },
  "headers": null,
  "cache_ttl": 0,
  "timeout": 15,
  "rate_limit_per_min": 60,
  "retry_count": 2,
  "retry_backoff": "exponential",
  "sort_order": 0,
  "status": "active",
  "tags": [],
  "last_tested_at": null,
  "last_test_response_ms": null,
  "server_uuid": "836995ae-1cff-41ec-823e-a4f07ccca3a0",
  "server_hex": "a1b2c3d4e5f6a1b2",
  "created_at": "2025-03-18T10:00:00Z",
  "updated_at": "2025-03-18T12:00:00Z"
}

​
Path Parameters

​
server_id
string
required
The UUID of the server the tool belongs to (e.g. 836995ae-1cff-41ec-823e-a4f07ccca3a0). Numeric IDs are also accepted for backwards compatibility.
​
id
string
required
The UUID of the tool to update (e.g. 5376af81-6bb8-4b01-800c-508d7672e394). Numeric IDs are also accepted for backwards compatibility.

​
Body Parameters

All fields are optional. Only include fields you want to update.
​
name
string
Tool name.
​
description
string
Tool description.
​
endpoint_url
string
API endpoint URL. Supports {{param}} path placeholders.
​
http_method
string
HTTP method: GET, POST, PUT, PATCH, DELETE.
​
input_schema
object
JSON Schema for input parameters.
​
parameter_mapping
object
Maps input parameters to their location in the outbound HTTP request. Each key is a parameter name; the value is an object with:
  • target (string, required): path, query, body, or header.
  • key (string, optional): the key name to use in the request. Defaults to the parameter name.
​
headers
object
Custom HTTP headers to include in every request to the external API.
​
cache_ttl
integer
Cache TTL in seconds.
​
timeout
integer
Request timeout in seconds.
​
retry_count
integer
Number of automatic retries on failure (0–5). Retries on connection errors and HTTP status codes 408, 429, 500, 502, 503, 504.
​
retry_backoff
string
Delay strategy between retries. One of: none (retry immediately), linear (1s, 2s, 3s…), exponential (1s, 2s, 4s…).
​
status
string
Tool status: active or paused.
curl --request PATCH \
     --url https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools/5376af81-6bb8-4b01-800c-508d7672e394 \
     --header 'Authorization: Bearer gmcp_your_api_key' \
     --header 'content-type: application/json' \
     --data '
{
  "description": "Create a new customer in Stripe with metadata support",
  "timeout": 15,
  "retry_count": 2,
  "status": "active"
}
'

{
  "id": 5,
  "uuid": "5376af81-6bb8-4b01-800c-508d7672e394",
  "server_id": 1,
  "name": "create_customer",
  "description": "Create a new customer in Stripe with metadata support",
  "endpoint_url": "https://api.stripe.com/v1/customers",
  "http_method": "POST",
  "input_schema": {
    "type": "object",
    "properties": {
      "email": {"type": "string"},
      "name": {"type": "string"}
    },
    "required": ["email"]
  },
  "parameter_mapping": {
    "email": {"target": "body", "key": "email"},
    "name": {"target": "body", "key": "name"}
  },
  "response_mapping": {
    "selector": "",
    "format": "json",
    "template": ""
  },
  "headers": null,
  "cache_ttl": 0,
  "timeout": 15,
  "rate_limit_per_min": 60,
  "retry_count": 2,
  "retry_backoff": "exponential",
  "sort_order": 0,
  "status": "active",
  "tags": [],
  "last_tested_at": null,
  "last_test_response_ms": null,
  "server_uuid": "836995ae-1cff-41ec-823e-a4f07ccca3a0",
  "server_hex": "a1b2c3d4e5f6a1b2",
  "created_at": "2025-03-18T10:00:00Z",
  "updated_at": "2025-03-18T12:00:00Z"
}