App hosting your agent runs: git, deploys, staging/production, Postgres. Owner approves risky steps.
Maintain this server? Claim it
This server signs you in with OAuth, which the playground doesn't support yet. Install it in your MCP client to try it.
Create a Plinth account for your human owner (or join theirs if their email already has one). Plinth emails them a link to approve; then call account.status with the returned signup_id and poll to collect your token.
| Argument | Type | Description |
|---|---|---|
| agent | string | Your name, e.g. Claude |
| email* | string | Owner email |
| project | string | Optional first project name |
{
"type": "object",
"required": [
"email"
],
"properties": {
"agent": {
"type": "string",
"description": "Your name, e.g. Claude"
},
"email": {
"type": "string",
"description": "Owner email"
},
"project": {
"type": "string",
"description": "Optional first project name"
}
}
}Finish signup: checks whether the owner approved, and returns your token (once) when they have.
| Argument | Type | Description |
|---|---|---|
| poll* | string | From account.create |
| signup_id* | string | From account.create |
{
"type": "object",
"required": [
"signup_id",
"poll"
],
"properties": {
"poll": {
"type": "string",
"description": "From account.create"
},
"signup_id": {
"type": "string",
"description": "From account.create"
}
}
}Agents that have a key to this account, when each was last used, and which one you are.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Owner only. Remove an agent's access to this account immediately.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
}Visitors and page views per day, top pages, where visitors come from, and phone vs desktop. No cookies; visitors are counted per day. Free shows today; Pro up to 90 days.
| Argument | Type | Description |
|---|---|---|
| env | string | Environment: production, staging, or a preview name |
| days | number | Default 30 (Pro) or 1 (Free) |
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"days": {
"type": "number",
"description": "Default 30 (Pro) or 1 (Free)"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Withdraw a pending approval request you made (for example one that is no longer needed). The owner can no longer approve it.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
}Check an approval. When approved, result holds the action output.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
}Approvals requested by this account, newest first. status: pending, approved, denied, cancelled, superseded (default all). Pending ones include approve_url, which the signed-in owner can approve at (the owner also gets each request by email).
| Argument | Type | Description |
|---|---|---|
| status | string | pending, approved, denied, cancelled, superseded (default all) |
{
"type": "object",
"required": [],
"properties": {
"status": {
"type": "string",
"description": "pending, approved, denied, cancelled, superseded (default all)"
}
}
}Ask the owner to add or replace the payment card. Returns an approve_url; approving opens a Stripe page where the owner enters the card. Plinth never sees card numbers. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Whether a card is on file, this month's spend, the spend cap and recent charges.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}List files in the project repo (path and size) on a branch or commit.
| Argument | Type | Description |
|---|---|---|
| ref | string | Branch or commit, default main |
| prefix | string | Only files under this folder |
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"ref": {
"type": "string",
"description": "Branch or commit, default main"
},
"prefix": {
"type": "string",
"description": "Only files under this folder"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Read one file from the project repo. Text comes back as utf8; binary files as base64.
| Argument | Type | Description |
|---|---|---|
| ref | string | Branch or commit, default main |
| path* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"path"
],
"properties": {
"ref": {
"type": "string",
"description": "Branch or commit, default main"
},
"path": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Commit files to the project without git: for agents that cannot run git or the CLI (e.g. Claude or ChatGPT in the cloud). Writes and deletes files on a branch (main deploys to staging; other branches get preview environments) and starts the deploy. Send whole files; text as utf8, binary as base64. Up to 5 MB per file.
| Argument | Type | Description |
|---|---|---|
| files | array | |
| branch | string | Default main |
| delete | array | Paths to remove |
| message | string | Commit message |
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"content"
],
"properties": {
"path": {
"type": "string"
},
"content": {
"type": "string"
},
"encoding": {
"type": "string",
"description": "utf8 (default) or base64"
}
}
}
},
"branch": {
"type": "string",
"description": "Default main"
},
"delete": {
"type": "array",
"items": {
"type": "string"
},
"description": "Paths to remove"
},
"message": {
"type": "string",
"description": "Commit message"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Get the owner into the web console. Plinth emails the owner a sign-in link; approving it signs that browser in for 12 hours. The agent never receives a session. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Schedule a job: Plinth POSTs to path on the environment at each tick (5-field cron, UTC), with the header x-plinth-cron-secret. Paths under /api/cron/ refuse any other caller. Outside production jobs start paused unless enabled is true. Jobs can also be declared in plinth.json "crons".
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| name* | string | |
| path* | string | e.g. /api/cron/digest |
| enabled | boolean | |
| project* | string | Project name |
| schedule* | string | e.g. "0 9 * * 1" or "*/5 * * * *" |
{
"type": "object",
"required": [
"project",
"env",
"name",
"schedule",
"path"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"name": {
"type": "string"
},
"path": {
"type": "string",
"description": "e.g. /api/cron/digest"
},
"enabled": {
"type": "boolean"
},
"project": {
"type": "string",
"description": "Project name"
},
"schedule": {
"type": "string",
"description": "e.g. \"0 9 * * 1\" or \"*/5 * * * *\""
}
}
}Cron jobs on an environment with last run and next run.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Pause a cron job (it stays defined but does not run).
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| name* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env",
"name"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"name": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Delete a cron job.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| name* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env",
"name"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"name": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Resume a paused cron job.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| name* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env",
"name"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"name": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Run a cron job now and return its result.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| name* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env",
"name"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"name": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Recent runs of a cron job.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| name* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env",
"name"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"name": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Get the DATABASE_URL for an environment (the same one the app receives). Production needs owner approval. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Apply pending migrations from the live release now (deploys do this automatically). Takes a snapshot first. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Applied and pending migrations (files in migrations/*.sql, applied in name order).
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Run SQL against an environment database. Returns up to 500 rows. On production, reads (SELECT, WITH, SHOW, EXPLAIN) run in a read-only transaction; any write needs owner approval. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| sql* | string | |
| params | array | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env",
"sql"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"sql": {
"type": "string"
},
"params": {
"type": "array",
"items": {}
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Restore an environment database from a snapshot. Takes a safety snapshot first. Production needs owner approval. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
| snapshot* | string |
{
"type": "object",
"required": [
"project",
"env",
"snapshot"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
},
"snapshot": {
"type": "string"
}
}
}Take a snapshot (pg_dump) of an environment database.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| label | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"label": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}List snapshots for an environment. Staging and production get one automatically every night at 03:00 UTC, kept 7 days.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Rebuild and deploy the head of the branch an environment tracks (staging tracks main). Production only changes via promote.
| Argument | Type | Description |
|---|---|---|
| env | string | Environment: production, staging, or a preview name |
| commit | string | Optional commit sha; defaults to branch head |
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"commit": {
"type": "string",
"description": "Optional commit sha; defaults to branch head"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Stop a build that is still running (the latest one in the environment, or a given release id). The live release keeps serving.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
| release | string |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
},
"release": {
"type": "string"
}
}
}Releases for an environment, newest first, with status and build log of the latest. Pass log_from (a character offset) to get only the log written since; build_log_length tells you where to continue.
| Argument | Type | Description |
|---|---|---|
| env | string | Environment: production, staging, or a preview name |
| limit | number | |
| project* | string | Project name |
| log_from | number |
{
"type": "object",
"required": [
"project"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"limit": {
"type": "number"
},
"project": {
"type": "string",
"description": "Project name"
},
"log_from": {
"type": "number"
}
}
}Buy a domain and connect it to an environment: registers it, points DNS at Plinth, issues HTTPS. Always shows the owner the exact price first. Standard registrations only. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| years | number | 1-10, default 1 |
| domain* | string | e.g. acme.dev (run domains.search first) |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env",
"domain"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"years": {
"type": "number",
"description": "1-10, default 1"
},
"domain": {
"type": "string",
"description": "e.g. acme.dev (run domains.search first)"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Map a domain you own to an environment. Point its DNS at the Plinth host; returns the record to create.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| host* | string | e.g. crm.acme.co |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env",
"host"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"host": {
"type": "string",
"description": "e.g. crm.acme.co"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Domains mapped to a project.
| Argument | Type | Description |
|---|---|---|
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"type": "string",
"description": "Project name"
}
}
}Domains bought through Plinth on this account, with price, status and expiry.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Unmap a domain.
| Argument | Type | Description |
|---|---|---|
| host* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"host"
],
"properties": {
"host": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Check if domains can be bought here, with price. Pass a name ("acme" checks acme.com, .dev, .app, .io, .co, .net, .ai, .org) or a full domain.
| Argument | Type | Description |
|---|---|---|
| query* | string | e.g. acme or acme.dev |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "e.g. acme or acme.dev"
}
}
}Check the TXT record of a connected domain; once it matches, the domain is served.
| Argument | Type | Description |
|---|---|---|
| host* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"host"
],
"properties": {
"host": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Production needs owner approval. Run a shell command inside the environment's running sandbox (same code, env vars, network and limits as the app), e.g. "node -e '...'", "ls", "env | sort". 30s timeout, 20 KB of output. Code is read-only; /tmp is writable. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| command* | string | |
| project* | string | Project name |
| timeout_seconds | number |
{
"type": "object",
"required": [
"project",
"env",
"command"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"command": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
},
"timeout_seconds": {
"type": "number"
}
}
}Environments for a project with live release and URL.
| Argument | Type | Description |
|---|---|---|
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"type": "string",
"description": "Project name"
}
}
}Restart an environment on its current release (fresh sandbox, same code and data).
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Set many environment variables at once from .env text (KEY=value lines; # comments, quotes and "export" are fine). One restart at the end. Keys starting with VITE_/NEXT_PUBLIC_/PUBLIC_ also reach the build.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| dotenv* | string | Contents of a .env file |
| project* | string | Project name |
| replace | boolean | Remove variables not in the file (default false) |
{
"type": "object",
"required": [
"project",
"env",
"dotenv"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"dotenv": {
"type": "string",
"description": "Contents of a .env file"
},
"project": {
"type": "string",
"description": "Project name"
},
"replace": {
"type": "boolean",
"description": "Remove variables not in the file (default false)"
}
}
}List environment variable names (values are never returned).
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Set an environment variable for an environment. Restarts the env so it takes effect.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| key* | string | |
| value* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env",
"key",
"value"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"key": {
"type": "string"
},
"value": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Remove an environment variable.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| key* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env",
"key"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"key": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Debug an environment: is it running, restarts, out-of-memory kills, memory/CPU use, live release, and the last errors from its logs.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Branches and their head commits.
| Argument | Type | Description |
|---|---|---|
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"type": "string",
"description": "Project name"
}
}
}Recent commits on a branch.
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| branch | string | Default main |
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"limit": {
"type": "number"
},
"branch": {
"type": "string",
"description": "Default main"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Get the authenticated git remote URL for pushing. Pushing main deploys staging; any other branch gets a preview environment.
| Argument | Type | Description |
|---|---|---|
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"type": "string",
"description": "Project name"
}
}
}Revert a commit on a branch server-side. The new commit deploys like a push.
| Argument | Type | Description |
|---|---|---|
| branch | string | Default main |
| commit* | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"commit"
],
"properties": {
"branch": {
"type": "string",
"description": "Default main"
},
"commit": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Send one HTTP request to the environment from inside Plinth and return status, headers, timing and the first 8 KB of the body. Use it to reproduce a failing route.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| body | string | |
| path | string | e.g. /api/orders?id=3 |
| method | string | |
| headers | object | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"body": {
"type": "string"
},
"path": {
"type": "string",
"description": "e.g. /api/orders?id=3"
},
"method": {
"type": "string"
},
"headers": {
"type": "object"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Logs for an environment: app stdout/stderr, build, cron and system lines. Filter by text and stream.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| grep | string | |
| limit | number | |
| since | string | 30s, 15m, 2h, 7d (default 15m) |
| stream | string | stdout, stderr, build, cron, system |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"grep": {
"type": "string"
},
"limit": {
"type": "number"
},
"since": {
"type": "string",
"description": "30s, 15m, 2h, 7d (default 15m)"
},
"stream": {
"type": "string",
"description": "stdout, stderr, build, cron, system"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Request count, error rate and latency percentiles for an environment.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| since | string | |
| project* | string | Project name |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"since": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Owner only. Choose which approval types run without asking. Keys: project.create, project.delete, promote.production, migration.destructive, db.restore.production, billing.
| Argument | Type | Description |
|---|---|---|
| auto_approve* | array |
{
"type": "object",
"required": [
"auto_approve"
],
"properties": {
"auto_approve": {
"type": "array",
"items": {
"type": "string"
}
}
}
}Create a project: a git repo plus production and staging environments, each with its own Postgres database. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
| Argument | Type | Description |
|---|---|---|
| name* | string | Lowercase name, 3-40 chars, e.g. acme-crm |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Lowercase name, 3-40 chars, e.g. acme-crm"
}
}
}Delete a project, its repo, environments and databases. Irreversible. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
| Argument | Type | Description |
|---|---|---|
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"type": "string",
"description": "Project name"
}
}
}Move a project back to the free plan. Its custom domains stop being served. The subscription shrinks with a prorated credit.
| Argument | Type | Description |
|---|---|---|
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"type": "string",
"description": "Project name"
}
}
}Show one project: git remote, environments, live release per environment, URLs.
| Argument | Type | Description |
|---|---|---|
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"type": "string",
"description": "Project name"
}
}
}List projects with their environments, live releases and URLs.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Move a project to Pro ($19/month per project): own domains and more room. Charges the owner's card now (prorated) after they approve. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
| Argument | Type | Description |
|---|---|---|
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"type": "string",
"description": "Project name"
}
}
}Promote the release running on one environment to another (default staging to production). Applies pending migrations first. May return pending_approval: the owner is emailed a link to approve; tell them it is waiting, then poll approval.status.
| Argument | Type | Description |
|---|---|---|
| to | string | Default production |
| from | string | Default staging |
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"to": {
"type": "string",
"description": "Default production"
},
"from": {
"type": "string",
"description": "Default staging"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Recent HTTP requests to an environment: method, path, status, time taken. Filter to failures with min_status 500, or by path.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| path | string | |
| limit | number | |
| since | string | |
| project* | string | Project name |
| min_status | number |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"path": {
"type": "string"
},
"limit": {
"type": "number"
},
"since": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name"
},
"min_status": {
"type": "number"
}
}
}Point an environment back at its previous release (or a given release id). Does not roll back the database.
| Argument | Type | Description |
|---|---|---|
| env* | string | Environment: production, staging, or a preview name |
| project* | string | Project name |
| release | string |
{
"type": "object",
"required": [
"project",
"env"
],
"properties": {
"env": {
"type": "string",
"description": "Environment: production, staging, or a preview name"
},
"project": {
"type": "string",
"description": "Project name"
},
"release": {
"type": "string"
}
}
}Check how search engines see an environment (title, description, robots.txt, sitemap, noindex) and get the steps to connect OpenSEO (openseo.so), an open-source SEO tool your agent uses over MCP: keyword research, rank tracking, backlinks, site audits. The owner signs up on OpenSEO; Plinth does not share any data with it.
| Argument | Type | Description |
|---|---|---|
| env | string | Default production |
| project* | string | Project name |
{
"type": "object",
"required": [
"project"
],
"properties": {
"env": {
"type": "string",
"description": "Default production"
},
"project": {
"type": "string",
"description": "Project name"
}
}
}Your support tickets with their status and the team's reply.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Send the Plinth team a bug report, feature request or question. Include what you tried and what happened. Recent errors for the project are attached automatically. Replies show up in support.list.
| Argument | Type | Description |
|---|---|---|
| env | string | Optional environment |
| body* | string | Details: steps, expected vs actual, commands, error text |
| kind* | string | bug, feature, question or other |
| title* | string | One line |
| project | string | Optional project it is about |
{
"type": "object",
"required": [
"kind",
"title",
"body"
],
"properties": {
"env": {
"type": "string",
"description": "Optional environment"
},
"body": {
"type": "string",
"description": "Details: steps, expected vs actual, commands, error text"
},
"kind": {
"type": "string",
"description": "bug, feature, question or other"
},
"title": {
"type": "string",
"description": "One line"
},
"project": {
"type": "string",
"description": "Optional project it is about"
}
}
}Replace your own agent token with a new one; the old one stops working immediately. Save the new token in ~/.plinth/config.json (the CLI does this for you).
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Send Plinth events to a URL (your bot, Slack, Discord, Telegram, Zapier...). Events: deploy.succeeded, deploy.failed, approval.requested, approval.decided, app.down, app.up, support.created, support.replied, charge.succeeded, signup.approved. Leave events empty for all. Payloads are JSON with a "text" summary and an x-plinth-signature HMAC header; Slack/Discord webhook URLs and Telegram sendMessage URLs work as-is.
| Argument | Type | Description |
|---|---|---|
| url* | string | https URL |
| events | array | |
| authorization | string | Optional Authorization header value, e.g. "Bearer abc". Stored encrypted. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "https URL"
},
"events": {
"type": "array",
"items": {
"type": "string"
}
},
"authorization": {
"type": "string",
"description": "Optional Authorization header value, e.g. \"Bearer abc\". Stored encrypted."
}
}
}Your webhooks with their last delivery status.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Delete a webhook.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
}Send a test event to all your webhooks; check webhooks.list a few seconds later for the result.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Show the account this token belongs to, its policy and projects.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}