Skip to main content
GET
/
wp-json
/
getmcp
/
v1
/
servers
/
{server_id}
/
tools
curl --request GET \
     --url https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools \
     --header 'Authorization: Bearer gmcp_your_api_key'

[
  {
    "id": 1,
    "uuid": "e7a3c1d2-4f5b-6a7c-8d9e-0f1a2b3c4d5e",
    "server_id": 1,
    "name": "get_weather",
    "description": "Get current weather for a city",
    "endpoint_url": "https://wttr.in/{{city}}?format=j1",
    "http_method": "GET",
    "input_schema": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string",
          "description": "The city name"
        }
      },
      "required": ["city"]
    },
    "parameter_mapping": {
      "city": {"target": "path", "key": "city"}
    },
    "response_mapping": {
      "selector": "",
      "format": "json",
      "template": ""
    },
    "headers": null,
    "cache_ttl": 300,
    "timeout": 30,
    "rate_limit_per_min": 60,
    "retry_count": 0,
    "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-01T10:00:00Z",
    "updated_at": "2025-03-01T10:00:00Z"
  }
]

​
Path Parameters

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

​
Query Parameters

​
per_page
integer
default:"50"
Number of tools per page.
​
page
integer
default:"1"
Page number.
​
status
string
Filter by status. One of: active, paused. Leave empty for all.

​
Response Headers

HeaderDescription
X-WP-TotalTotal number of tools
curl --request GET \
     --url https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools \
     --header 'Authorization: Bearer gmcp_your_api_key'

[
  {
    "id": 1,
    "uuid": "e7a3c1d2-4f5b-6a7c-8d9e-0f1a2b3c4d5e",
    "server_id": 1,
    "name": "get_weather",
    "description": "Get current weather for a city",
    "endpoint_url": "https://wttr.in/{{city}}?format=j1",
    "http_method": "GET",
    "input_schema": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string",
          "description": "The city name"
        }
      },
      "required": ["city"]
    },
    "parameter_mapping": {
      "city": {"target": "path", "key": "city"}
    },
    "response_mapping": {
      "selector": "",
      "format": "json",
      "template": ""
    },
    "headers": null,
    "cache_ttl": 300,
    "timeout": 30,
    "rate_limit_per_min": 60,
    "retry_count": 0,
    "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-01T10:00:00Z",
    "updated_at": "2025-03-01T10:00:00Z"
  }
]