# Overview

plsk.org provides short-lived Plesk hosting subscriptions that are operated through MCP and REST interfaces. A subscription is a Plesk customer on a shared server with a site at `https://<id>.lab.plsk.org`, a file system, PHP 8.5, MySQL, and the Plesk REST API scoped to that customer.

| Property | Value |
|---|---|
| Provisioning time | approximately 25 s |
| Lifetime of a subscription | 14 days from the moment it is ready |
| Active subscriptions per account | 5 |

See [Limits](/limits) for resource limits.

## Endpoints

All interfaces are served from `https://api.plsk.org`.

| Base path | Interface | Credential | Reference |
|---|---|---|---|
| `/v1` | Account API: subscriptions, subscription keys, feedback. | Account key `plsa_…` | [Account API](/api/account) |
| `/api/plesk/v2` (alias `/api/v2`) | Plesk REST API of one subscription. | Subscription key `plsk_…` | [Plesk REST API](/api/plesk) |
| `/api/modules/wp-toolkit/v1` | WP Toolkit REST API of one subscription. | Subscription key `plsk_…` | [WP Toolkit REST API](/api/wp-toolkit) |
| `/mcp` | MCP server (Streamable HTTP). | OAuth 2.0 access token `plso_…` | [MCP reference](/mcp) |

Machine-readable descriptions:

| Path | Content |
|---|---|
| `/openapi.json` | OpenAPI document of the account API and the gateway. |
| `/plesk-openapi.json` | OpenAPI document of the Plesk REST API, with the gateway as its server. No credential required. |
| `/.well-known/api-catalog` | API catalog (RFC 9727). |
| `/.well-known/oauth-protected-resource/mcp` | OAuth protected resource metadata of the MCP server. |

## Documentation

- [API reference](/api): authentication, request handling, error format.
- [MCP reference](/mcp): tools, parameters, scopes.
- Examples: [MCP session](/quickstart-agent), [REST session](/quickstart-rest), [static site](/examples/static-site), [PHP and MySQL](/examples/php-mysql), [WordPress](/examples/wordpress), [subdomains and certificates](/examples/subdomains).
- [Troubleshooting](/troubleshooting).
- [Limits](/limits), [Feedback](/feedback).
