Tools
Every tool of Basemodo's MCP, with its arguments, what it does and how it differs on the Remote MCP.
Each tool is a command of the CLI, named after its words joined by _: env set is env_set. It takes the command's arguments as JSON keys, and answers what the command prints with --json. When it fails, the error result carries the same {"error": ...} as the command, with its fix.
The Remote MCP and the local one serve the same tools. The Remote MCP has no folder of yours, so a tool that acts on an App needs the App's name (app), deploy takes a GitHub repository instead of a folder, and download answers the link to the App's Backups page instead of writing a file. Each tool's page says what changes.
A tool that only reads may run without your client asking you; one that changes things may ask first. A few commands stay in the terminal, like basemodo login: the CLI says which, and why.
Every tool
| Tool | What it does | It |
|---|---|---|
deploy | Deploy a folder and print its URL once it is live | changes things |
deploys | List an App's Deploys, newest first, each with who made it and what it changed | reads |
files | List or read an App's code, one of its Deploys', or a Template's | reads |
change | Change an App's code: write, edit or delete files, deployed as one Deploy | changes things |
diff | Show what a Deploy changed in its App's code, file by file | reads |
rollback | Make an earlier Deploy live again, as a new Deploy | changes things |
restart | Restart an App: its Machine starts again on its live Deploy | changes things |
status | Say whether an App is awake, asleep, starting or paused, and its latest Deploy | reads |
open | Open an App's URL in your browser | reads |
logs | Follow an App's Logs live, or print its last lines with --lines | reads |
env_set | Set Secrets: NAME=value ..., or one NAME alone to read its value from stdin. The App gets them the next time it starts: basemodo restart | changes things |
env_list | List the App's Secrets by name, with who set each and when. Never values | reads |
env_unset | Remove Secrets by name (all or none). The App loses them the next time it starts: basemodo restart | changes things |
callers_list | List the App's Callers, with who named each and when, and the paths it exposes to them | reads |
callers_add | Let another App of the same Owner call this one: name it a Caller | changes things |
callers_remove | Take a Caller off: its next call is refused | changes things |
share | Share an App: invite Members and Editors by email, remove them, answer Access Requests, or change its Visibility | changes things |
indexing | Let search engines index a Public App (on), keep them out (off), or say which | changes things |
toolbar | Turn off the Toolbar on an App's pages (off), turn it back on (on), or say which | changes things |
recognize | Have a Public App ask visitors already signed in to Basemodo to continue as themselves (on), let them in as Guests again (off), or say which | changes things |
egress | Give an App an outgoing address of its own (dedicated), give it back (shared), or say where its traffic leaves from | changes things |
rename | Rename an App; its old address redirects to the new one for 30 days | changes things |
domains_add | Claim a hostname of yours for the App, and print the DNS records to add | changes things |
domains_verify | Look for a custom domain's DNS records now; once found, the App answers there | changes things |
domains_list | List the App's custom domains, each with its status and DNS records | reads |
domains_remove | Stop the App answering at a custom domain, and forget its certificate | changes things |
run | Run a one-off command inside an App's Machine (a migration, a script) | changes things |
runs | Follow a command an agent's run left running: what it printed and how it ended | reads |
db | Run SQL against an App's SQLite database (/data/app.db) and print the rows | changes things |
backup | Take a Backup of an App's data now: its database and every file on its volume | changes things |
backups | List an App's Backups, newest first, to choose one to restore | reads |
restore | Put an App's data back as a Backup holds it | changes things |
download | Download an App's data as it is now: one .tar.gz file of everything on its disk | changes things |
plan | Show your Plan and your next Invoice | reads |
plan_reserve | See or change a Workspace's Seats, Additional Apps and Always On Apps reserved ahead, for its Admins | changes things |
pull | Bring an App's latest code into a folder: a new one, or one that came from it | changes things |
transfers_list | List the pending Transfers you asked for or may answer, with each App's Editors | reads |
transfers_accept | Accept a Transfer: the App becomes yours, or your Workspace's, at the same URL | changes things |
transfers_decline | Decline a Transfer: the App stays where it is | changes things |
whoami | Print who this CLI is signed in as | reads |
docs | Read the documentation of basemodo.com/docs: every page, or one topic | reads |
feedback | Tell Basemodo what is wrong or missing, as the signed-in Person | changes things |
account_delete | Erase your account for good: type its email to confirm | changes things |