Reference
MCP tools
The platform as tools an agent can call.
Start the server with npx -y uarpie mcp --client <name>. Every tool carries a title and readOnlyHint / destructiveHint annotations; compliant clients use them to decide when to ask the person first. This is every tool the server offers.
| Tool | Read-only | Destructive | What it does |
|---|---|---|---|
deploy | no | no | Detect, build and put an app online. Returns bind_url on the first deploy. |
status | yes | no | Address, live version, in-progress update, what it has used this month, current link |
logs | yes | no | Recent runtime activity, since a time or containing some text if asked |
doctor | yes | no | What is wrong with a running app: the latest crash, the file where it starts, the version that brought it, and a fix |
versions | yes | no | Every deploy, newest first |
deployment_log | yes | no | The trace of one deploy: steps and build output |
rollback | no | yes | Go back to one of the last 10 versions, in about half a minute (code only; the database stays as it is) |
set_secret | no | yes | Set one setting; makes a new version in seconds, or rebuilds the app (minutes) when the setting is read while building |
desktop_app | no | no | A Windows version of the app: a download to unzip and double-click. Mac and Linux are coming. |
busy_hours | no | no | Keep copies of the app awake at busy times. Costs money by existing: paid from the account's Uarpie credit by the hour, so it shows the monthly cost first. Refused with CREDIT_NEEDED when there is no credit |
instant_start | no | no | Make a Java app's new copies start in about a second, from a copy saved at each deploy. Costs money by existing, sold at cost from the account's Uarpie credit, so it shows the monthly price first and asks before turning it on. Not together with busy hours |
share | no | no | Invite a person by email |
add_domain | no | no | Attach a domain; returns the two DNS records to add where it was bought |
buy_domain | no | no | Not available yet: every call is refused and nothing is bought |
estimate | yes | no | What running the app costs the platform in a month, with a breakdown; not a price |
list_projects | yes | no | Apps in the signed-in account |
login | no | no | Start signing this computer in; returns a code and link for the person |
login_wait | no | no | Wait for the person to approve |
api_keys | yes | no | The keys an app has, without their secrets |
create_api_key | no | no | Make a new key; it is shown once |
revoke_api_key | no | yes | Stop a key working |
open_paths | no | no | Paths of a private app that anyone may read without signing in, such as a private CMS's pictures |
estimate_release | yes | no | The price of a phone build, as the quote release needs |
release | no | yes | Start a phone build at the quoted price, once the person has agreed. Nothing is sent to the App Store or Google Play. |
build_app | no | no | Build the Android app and hand back the files: one to install, one to upload to Google Play yourself. iPhone builds are not available. |
releases | yes | no | The phone builds made for an app, newest first: how far along each one is and what it cost |
clone | no | no | Put an app's source on this computer |
Results
Success returns the same shapes the dashboard uses. Failure returns the error contract with isError: true, so the agent reads fix, applies it, and calls again.
Naming the app
Tools that act on an app take project: a project id (prj_...) or the app's name. When omitted, the app in the current folder's deploy.json is used. Names require a signed-in account (login).
This page as Markdown: /docs/mcp-tools.mdllms.txt