All 37 MCP tools
Percher includes an MCP (Model Context Protocol) server so AI assistants like Claude Code, Cursor, and Windsurf can deploy and manage your apps directly.
// Claude Code: ~/.claude/mcp.json
// Cursor: .cursor/mcp.json
{
"mcpServers": {
"percher": {
"command": "npx",
"args": ["-y", "@percher/mcp"]
}
}
}percher_publishPublish (primary tool)Handles login, config, deploy, and error diagnosis in one call. Use this.percher_initGenerate percher.tomlDetects framework, runtime, port. Creates config file.percher_pushDeploy (low-level only)Packages, uploads, deploys. Use only when you need to isolate a phase — prefer percher_publish.percher_loginAuthenticateReturns a login URL for the browser flow, or accepts a token directly.percher_logsView app logsArgs: app (name or id), lines (default 50), follow (boolean).percher_env_setSet env variablesArgs: app, vars (object of key-value pairs).percher_env_unsetRemove env variableArgs: app, key.percher_env_listList env variablesArgs: app. Values are masked.percher_versionsDeployment historyArgs: app. Returns commit SHAs and timestamps.percher_rollbackRoll back to versionArgs: app, commitSha. Redeploys exact code from that version.percher_redeployRedeploy a specific deployArgs: app, deployId. Replays an existing deploy without re-uploading.percher_reproduceReproduce a deploy locallyArgs: app, deployId. Downloads the source bundle and re-runs the build for debugging.percher_doctorRecovery hubDiagnoses publish/deploy failures and returns recovery.nextAction. Call this whenever another tool's recovery says run_doctor.percher_unsuspendResume a suspended appLifts auto-suspension after the cooldown window.percher_dataDatabase statusShows PocketBase collections, stats, admin link.percher_data_exportExport PocketBase dataArgs: app. Downloads a snapshot tarball.percher_reset_superuserReset PocketBase adminGenerates new superuser credentials + env vars.percher_backupsList backupsArgs: app (optional). Returns backup ids, sizes, components.percher_restoreRestore from a backupArgs: app, source, components, dryRun. Per-app + per-component restore.percher_create_from_templateScaffold new appTemplates: 29+ starters incl. nextjs, sveltekit, astro, remix, nuxt, vite-react, fastapi, django, elysia, eleventy, hugo, laravel, rails, phoenix, go, rust, dotnet, java.percher_importImport from Vercel/NetlifyParses their config files and writes a percher.toml.percher_deploysList recent deploysArgs: app. Returns id, status, createdAt, errorMessage.percher_deploys_inspectInspect a specific deployArgs: app, id (or latestFailed). Returns full status + buildLog. Use after a failed publish.percher_domain_addAdd custom domainArgs: app, domain. Returns DNS instructions.percher_domain_verifyVerify domain DNSChecks TXT and CNAME/A records.percher_domain_listList custom domainsShows domains with verification status.percher_domain_removeRemove custom domainArgs: app, domain.percher_github_connectGitHub auto-deployArgs: app, repoUrl, branch. Clones the repo, deploys, returns webhook setup instructions.percher_github_setup_webhookRegenerate webhook secretArgs: app. Use after a failed github_connect.percher_whoamiCurrent user infoShows email and token status.percher_openGet app URLReturns the public URL for the app.percher_renameRename appChanges subdomain. Once per 30 days; old name reserved 60 days.percher_delete_appPermanently delete appRequires confirm: true. Removes container, DB, domains, env, history.percher_diagnose_crashLatest crash + AI analysisReturns explanation, suggestion, severity, log tail. Use when user says the app isn't working. Stale reports filtered.percher_app_insightsCost + reliability suggestionsReturns idle / memory-pressure / overprovisioned / deploy-regression. Each carries an actionHint the AI follows up with.percher_billing_upgradeGet a Polar checkout URLArgs: plan (starter/maker/pro). Returns URL; user confirms in browser.percher_billing_portalPolar customer portal URLManage, downgrade, cancel subscription. Returns url: null for never-subscribed users.