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'
import requests
response = requests.get(
"https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools",
headers={"Authorization": "Bearer gmcp_your_api_key"}
)
print(response.json())
const response = await fetch(
"https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools",
{
headers: { "Authorization": "Bearer gmcp_your_api_key" }
}
);
const data = await response.json();
$response = wp_remote_get(
"https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools",
["headers" => ["Authorization" => "Bearer gmcp_your_api_key"]]
);
$data = json_decode(wp_remote_retrieve_body($response), true);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools", nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
data, _ := io.ReadAll(resp.Body)
fmt.Println(string(data))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools"))
.GET()
.build();
HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI('https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
request = Net::HTTP::Get.new(uri)
response = http.request(request)
puts JSON.parse(response.body)
[
{
"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"
}
]
Tools
List Tools
Retrieve all tools configured for a specific server.
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'
import requests
response = requests.get(
"https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools",
headers={"Authorization": "Bearer gmcp_your_api_key"}
)
print(response.json())
const response = await fetch(
"https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools",
{
headers: { "Authorization": "Bearer gmcp_your_api_key" }
}
);
const data = await response.json();
$response = wp_remote_get(
"https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools",
["headers" => ["Authorization" => "Bearer gmcp_your_api_key"]]
);
$data = json_decode(wp_remote_retrieve_body($response), true);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools", nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
data, _ := io.ReadAll(resp.Body)
fmt.Println(string(data))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools"))
.GET()
.build();
HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI('https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
request = Net::HTTP::Get.new(uri)
response = http.request(request)
puts JSON.parse(response.body)
[
{
"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
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
integer
default:"50"
Number of tools per page.
integer
default:"1"
Page number.
string
Filter by status. One of:
active, paused. Leave empty for all.Response Headers
| Header | Description |
|---|---|
X-WP-Total | Total 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'
import requests
response = requests.get(
"https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools",
headers={"Authorization": "Bearer gmcp_your_api_key"}
)
print(response.json())
const response = await fetch(
"https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools",
{
headers: { "Authorization": "Bearer gmcp_your_api_key" }
}
);
const data = await response.json();
$response = wp_remote_get(
"https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools",
["headers" => ["Authorization" => "Bearer gmcp_your_api_key"]]
);
$data = json_decode(wp_remote_retrieve_body($response), true);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools", nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
data, _ := io.ReadAll(resp.Body)
fmt.Println(string(data))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools"))
.GET()
.build();
HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI('https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
request = Net::HTTP::Get.new(uri)
response = http.request(request)
puts JSON.parse(response.body)
[
{
"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"
}
]
⌘I

