Skip to main content
GET
/
wp-json
/
getmcp
/
v1
/
servers
curl -H "Authorization: Bearer gmcp_your_api_key" \
  "https://yoursite.com/wp-json/getmcp/v1/servers?per_page=10&status=active"

[
  {
    "id": 1,
    "user_id": 1,
    "name": "My Weather Tools",
    "slug": "my-weather-tools",
    "server_id": "a1b2c3d4e5f6a1b2",
    "status": "active",
    "transport_type": "streamable-http",
    "auth_type": "none",
    "rate_limit_per_min": 60,
    "settings": {
      "description": "Tools for retrieving weather data"
    },
    "endpoint_url": "https://yoursite.com/mcp/my-weather-tools/a1b2c3d4e5f6a1b2",
    "tool_count": 3,
    "created_at": "2025-03-01T10:00:00",
    "updated_at": "2025-03-15T14:30:00"
  },
  {
    "id": 2,
    "user_id": 1,
    "name": "Stripe Payments",
    "slug": "stripe-payments",
    "server_id": "b2c3d4e5f6a1b2c3",
    "status": "active",
    "transport_type": "streamable-http",
    "auth_type": "api-key",
    "rate_limit_per_min": 30,
    "settings": null,
    "endpoint_url": "https://yoursite.com/mcp/stripe-payments/b2c3d4e5f6a1b2c3",
    "tool_count": 8,
    "created_at": "2025-03-05T08:00:00",
    "updated_at": "2025-03-18T09:00:00"
  }
]

​
Query Parameters

​
per_page
integer
default:"20"
Number of servers per page. Min: 1, Max: 100.
​
page
integer
default:"1"
Page number for pagination.
​
status
string
Filter by server status. One of: active, paused, draft. Leave empty for all.
​
search
string
Search servers by name or slug.
​
orderby
string
default:"created_at"
Sort field. One of: id, name, slug, status, created_at, updated_at.
​
order
string
default:"DESC"
Sort direction. One of: ASC, DESC.

​
Response Headers

HeaderDescription
X-WP-TotalTotal number of matching servers
X-WP-TotalPagesTotal number of pages
curl -H "Authorization: Bearer gmcp_your_api_key" \
  "https://yoursite.com/wp-json/getmcp/v1/servers?per_page=10&status=active"

[
  {
    "id": 1,
    "user_id": 1,
    "name": "My Weather Tools",
    "slug": "my-weather-tools",
    "server_id": "a1b2c3d4e5f6a1b2",
    "status": "active",
    "transport_type": "streamable-http",
    "auth_type": "none",
    "rate_limit_per_min": 60,
    "settings": {
      "description": "Tools for retrieving weather data"
    },
    "endpoint_url": "https://yoursite.com/mcp/my-weather-tools/a1b2c3d4e5f6a1b2",
    "tool_count": 3,
    "created_at": "2025-03-01T10:00:00",
    "updated_at": "2025-03-15T14:30:00"
  },
  {
    "id": 2,
    "user_id": 1,
    "name": "Stripe Payments",
    "slug": "stripe-payments",
    "server_id": "b2c3d4e5f6a1b2c3",
    "status": "active",
    "transport_type": "streamable-http",
    "auth_type": "api-key",
    "rate_limit_per_min": 30,
    "settings": null,
    "endpoint_url": "https://yoursite.com/mcp/stripe-payments/b2c3d4e5f6a1b2c3",
    "tool_count": 8,
    "created_at": "2025-03-05T08:00:00",
    "updated_at": "2025-03-18T09:00:00"
  }
]