> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmcp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> GetMCP REST API reference — manage servers, tools, resources, prompts, and analytics programmatically.

## Base URL

All admin REST API endpoints are under the GetMCP namespace:

```
https://yoursite.com/wp-json/getmcp/v1
```

Replace `yoursite.com` with the domain of the WordPress site where GetMCP is installed.

## Authentication

The GetMCP admin API uses API key authentication. Every request must include your API key in the `Authorization` header.

```
Authorization: Bearer gmcp_your_api_key_here
```

### Generating Your API Key

<Steps>
  <Step title="Open GetMCP Settings">
    In your WordPress admin, navigate to **GetMCP > Settings**.
  </Step>

  <Step title="Go to the API Keys tab">
    Click the **API Keys** tab in the Settings page.
  </Step>

  <Step title="Generate a Key">
    Click **Generate New Key**. Your key will be displayed once — copy it immediately and store it securely.

    <img src="https://mintcdn.com/infiwebs/X3D8lQwdysxDpY3z/images/post-api-key.jpeg?fit=max&auto=format&n=X3D8lQwdysxDpY3z&q=85&s=b899f36a6662efa8cf82f4e17d16fca8" alt="GetMCP API Key Settings" width="1339" height="379" data-path="images/post-api-key.jpeg" />
  </Step>
</Steps>

<Warning>
  Your API key is shown only once at generation time. Store it in a secure location such as an environment variable or secrets manager. If you lose it, generate a new one — this immediately revokes the old key.
</Warning>

### Key Format

GetMCP API keys use 32-character hex string:

```
a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
```

### Example Request

```bash theme={null}
curl -H "Authorization: Bearer getmcp_api_key_here" \
  "https://yoursite.com/wp-json/getmcp/v1/servers"
```

## Response Format

All responses are JSON. Successful list endpoints return an array. Single-item endpoints return an object.

Pagination metadata is returned in response headers:

* `X-WP-Total` — Total number of items
* `X-WP-TotalPages` — Total number of pages

## Error Responses

Errors follow this format:

```json theme={null}
{
  "code": "getmcp_not_found",
  "message": "Server not found.",
  "data": {
    "status": 404
  }
}
```

### Common Error Codes

| Code                    | HTTP Status | Description                  |
| ----------------------- | ----------- | ---------------------------- |
| `rest_forbidden`        | 403         | Invalid or missing API key   |
| `getmcp_not_found`      | 404         | Resource not found           |
| `getmcp_create_failed`  | 500         | Failed to create resource    |
| `getmcp_update_failed`  | 500         | Failed to update resource    |
| `getmcp_delete_failed`  | 500         | Failed to delete resource    |
| `getmcp_missing_curl`   | 400         | cURL import: missing command |
| `getmcp_invalid_params` | 400         | Invalid parameters           |

## Two URL Spaces

GetMCP has two distinct URL spaces — do not confuse them:

| Purpose                                    | Base URL                                  | Auth                |
| ------------------------------------------ | ----------------------------------------- | ------------------- |
| **MCP Protocol** (AI clients connect here) | `https://yoursite.com/mcp/{slug}/{id}`    | MCP API key or none |
| **Admin REST API** (manage configuration)  | `https://yoursite.com/wp-json/getmcp/v1/` | GetMCP API key      |

This reference covers the **Admin REST API**. For the MCP Protocol endpoints, see [MCP Protocol Reference](/api-reference/mcp-protocol/overview).