referenceupdated November 13, 2026

vbtnl MCP server: tools reference

Every tool the vbtnl remote MCP server gives your AI agent: projects, files, commands, publishing, rollback, databases and logs.

The vbtnl MCP server lives at one address for every client:

Code

https://api.vbtnl.com/mcp

It is a remote server with the Streamable HTTP transport. Clients sign in with OAuth or send a personal token in the Authorization: Bearer header. You do not call the tools yourself: the agent picks them while it works. The list shows what it is able to do.

Projects

Tool	What it does
`list_projects`	Lists your projects.
`create_project`	Creates a project with a draft address.
`get_project_context`	Returns the state of a project: files, draft status, recent errors.
`delete_project`	Deletes a project. Asks for the project name as confirmation.
`get_platform_guide`	Returns the platform rules the agent follows.

Files

Tool	What it does
`list_files`	Lists files in the project.
`read_file`	Reads a file.
`write_file`, `write_files`	Creates or replaces one or several files.
`edit_file`	Changes part of a file.
`delete_file`	Deletes a file.
`search`	Searches the project files.

Running code

Tool	What it does
`exec`	Runs a shell command in the draft: tests, scripts, a request to the app.
`add_package`	Installs a package and records it in `requirements.txt` or `package.json`.
`restart_app`	Restarts the draft app.
`run_job`	Starts a long task in the background, up to 6 hours.
`get_job_result`	Returns the status and output of a background task.

Publishing

Tool	What it does
`publish`	Publishes the draft to production as a new numbered version.
`get_release`	Returns the status of a publish.
`rollback`	Switches production to an earlier version.
`get_build_logs`	Returns the build output of a version.

Data and settings

Tool	What it does
`add_database`	Adds Postgres: one database for the draft, one for production.
`run_sql`	Runs SQL on the draft database. Production is refused by default.
`describe_database`	Returns the structure of a database, without the values.
`set_secrets`	Saves secrets that reach the app as environment variables.
`get_logs`	Returns the app logs. Production logs come masked.

For how these fit together, see How a project works.

← vbtnl.json reference