MCP tools for AI assistants

All 27 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.

Setup

// Claude Code: ~/.claude/mcp.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "percher": {
      "command": "npx",
      "args": ["-y", "@percher/mcp"]
    }
  }
}

All tools (27)

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)Packages files, uploads tarball, triggers build + deploy. Prefer publish.

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_doctorHealth diagnosticsChecks auth, API, container, route, PocketBase, env, deploys.

percher_dataDatabase statusShows PocketBase collections, stats, admin link.

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_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_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_reset_superuserReset PocketBase adminGenerates new superuser credentials + env vars.

percher_importImport from Vercel/NetlifyParses their config files and writes a percher.toml.

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.

← Prevpercher.toml — full reference Next →Migrating from Supabase