Skip to main content
POST
/
wp-json
/
getmcp
/
v1
/
servers
curl -X POST \
  -H "Authorization: Bearer gmcp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GitHub Tools",
    "description": "Tools for managing GitHub repositories",
    "status": "active",
    "auth_type": "api-key",
    "rate_limit_per_min": 30
  }' \
  "https://yoursite.com/wp-json/getmcp/v1/servers"

{
  "id": 3,
  "user_id": 1,
  "name": "GitHub Tools",
  "slug": "github-tools",
  "server_id": "c3d4e5f6a1b2c3d4",
  "status": "active",
  "transport_type": "streamable-http",
  "auth_type": "api-key",
  "rate_limit_per_min": 30,
  "settings": {
    "description": "Tools for managing GitHub repositories"
  },
  "endpoint_url": "https://yoursite.com/mcp/github-tools/c3d4e5f6a1b2c3d4",
  "tool_count": 0,
  "created_at": "2025-03-18T10:00:00",
  "updated_at": "2025-03-18T10:00:00"
}

​
Body Parameters

​
name
string
required
Human-readable server name (e.g., My Weather Tools).
​
slug
string
URL slug for the MCP endpoint. Auto-generated from name if not provided. Must be unique.
​
description
string
Optional description of what this server does.
​
status
string
default:"active"
Initial server status. One of: active, paused, draft.
​
auth_type
string
default:"none"
Inbound authentication type for the MCP endpoint. One of: none, api-key, oauth.
​
cors_origins
string
Comma-separated list of allowed CORS origins. Leave null to allow all origins.
​
rate_limit_per_min
integer
default:"60"
Maximum MCP requests per minute for this server.
curl -X POST \
  -H "Authorization: Bearer gmcp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GitHub Tools",
    "description": "Tools for managing GitHub repositories",
    "status": "active",
    "auth_type": "api-key",
    "rate_limit_per_min": 30
  }' \
  "https://yoursite.com/wp-json/getmcp/v1/servers"

{
  "id": 3,
  "user_id": 1,
  "name": "GitHub Tools",
  "slug": "github-tools",
  "server_id": "c3d4e5f6a1b2c3d4",
  "status": "active",
  "transport_type": "streamable-http",
  "auth_type": "api-key",
  "rate_limit_per_min": 30,
  "settings": {
    "description": "Tools for managing GitHub repositories"
  },
  "endpoint_url": "https://yoursite.com/mcp/github-tools/c3d4e5f6a1b2c3d4",
  "tool_count": 0,
  "created_at": "2025-03-18T10:00:00",
  "updated_at": "2025-03-18T10:00:00"
}