Skip to main content
POST
/
wp-json
/
getmcp
/
v1
/
servers
/
{server_id}
/
tools
/
export
curl --request POST \
     --url https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools/export \
     --header 'Authorization: Bearer gmcp_your_api_key' \
     --header 'content-type: application/json' \
     --data '{
    "tool_ids": [
        "448fd610-2a86-4e49-b4db-f2e8d2af381b",
        "bf707299-9d5f-4996-9a19-e2dd634be3b8",
        "5c0035c6-ad10-4c4c-a61f-14549ef112a4"
    ]
}'

{
  "format": "getmcp/tools-v1",
  "exported_at": "2025-03-18T10:00:00+00:00",
  "server": {
    "name": "My Weather Tools",
    "slug": "my-weather-tools"
  },
  "tools": [
    {
      "name": "Get Weather",
      "slug": "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,
      "timeout": 30,
      "cache_ttl": 300,
      "retry_count": 0,
      "retry_backoff": "exponential",
      "rate_limit_per_min": 60,
      "status": "active",
      "tags": [],
      "sort_order": 0
    }
  ]
}
Returns a versioned JSON manifest of every tool on the server (or a selected subset). Pair with POST /tools/import-getmcp on the receiving server to clone the catalog.
Identifiers (id, uuid, server_id) and bookkeeping fields (created_at, updated_at, last_tested_at, last_test_response_ms) are deliberately stripped — they’re meaningless on the receiving server. Authentication is not included; configure auth on the destination server separately.
Tools are exported regardless of status — draft, active, and inactive rows all land in the manifest with their original status field intact.

​
Path Parameters

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

​
Body Parameters

​
tool_ids
array
Optional array of tool UUIDs to limit the export to. When omitted (or empty), every tool on the server is exported. UUIDs that don’t belong to the server are silently skipped.
curl --request POST \
     --url https://yoursite.com/wp-json/getmcp/v1/servers/836995ae-1cff-41ec-823e-a4f07ccca3a0/tools/export \
     --header 'Authorization: Bearer gmcp_your_api_key' \
     --header 'content-type: application/json' \
     --data '{
    "tool_ids": [
        "448fd610-2a86-4e49-b4db-f2e8d2af381b",
        "bf707299-9d5f-4996-9a19-e2dd634be3b8",
        "5c0035c6-ad10-4c4c-a61f-14549ef112a4"
    ]
}'

{
  "format": "getmcp/tools-v1",
  "exported_at": "2025-03-18T10:00:00+00:00",
  "server": {
    "name": "My Weather Tools",
    "slug": "my-weather-tools"
  },
  "tools": [
    {
      "name": "Get Weather",
      "slug": "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,
      "timeout": 30,
      "cache_ttl": 300,
      "retry_count": 0,
      "retry_backoff": "exponential",
      "rate_limit_per_min": 60,
      "status": "active",
      "tags": [],
      "sort_order": 0
    }
  ]
}

​
Response Fields

​
format
string
Manifest format identifier. Currently getmcp/tools-v1. Importers reject anything not prefixed with getmcp/tools-v.
​
exported_at
string
ISO 8601 UTC timestamp of when the manifest was generated.
​
server
object
Source server metadata (name, slug) — informational only.
​
tools
array
Array of tool objects in sort_order ascending. See the import endpoint for the per-tool field reference.