Portal

MCP tool reference

Server: https://api.beta.kaviris.com/mcp (Streamable HTTP, OAuth with PKCE; your host signs you in, no token to paste).

Tool Does Needs
whoami Who the agent acts for, and what it may do read
list_apps, get_app Your apps; one app's state, address and last deploy read
create_app Reserve a name and get the app id create and deploy
create_upload A one-time upload URL (15 minutes, up to 200 MB) and the command that uploads the committed source create and deploy
deploy Start a deploy from an upload create and deploy
get_deploy Follow a deploy: status, refusals, upgrades (one patch for all recommended upgrades), address. Waits up to 55 seconds per call read
get_logs With app: the running app's logs (since, q, limit). With deploy_id: the build log read
get_metrics Visits, errors, response times, memory, database size, hours awake, wake-ups; window 1h to 30d (numbers and logs) read
draft_contract Draft the contract from your source without deploying create and deploy
get_contract, update_contract, approve_contract Read the contract, change the draft with a JSON Patch, put it in force; removing or resizing a disk asks for a confirm_token first read / create and deploy
set_secret, list_secrets Set a secret by reference (one-time URL and a command) or, if unavoidable, by value; list names and state set secrets / read
list_releases, rollback, get_operation Earlier releases, going back to one, following it read / delete and roll back
get_change_request The status of something the agent asked a person to approve read
suspend_app, resume_app Stop an app (visitors see a notice page) and start it again delete and roll back / create and deploy
list_backups, restore_app Backups and the last restore test; restore the database to a moment in the last 7 days read / delete and roll back
export_app A one-time download of your source, contract and secret names. The database is exported by an owner or admin in the portal read
grant_support, list_support_grants, revoke_support_grant Give support time-limited access for one case, see what it read, withdraw it (Support) create and deploy
list_github_repos, link_github Repositories of your connected GitHub account; link one to an app (GitHub, when the GitHub App launches) read / create and deploy, as an owner or admin
delete_app Archive an app; its data is destroyed after 30 days delete and roll back
send_feedback Tell the Kaviris team about a problem, a wish or anything else in the beta (category bug, idea or other; text; optionally app, deploy_id, refusal_code). 5 an hour and 20 a day per agent key; the answer is a reference. Also POST /v1/feedback (Feedback) none beyond membership of the key's organisation

Statuses of a deploy

queued → building → checking → releasing → live. A deploy can also end refused or failed, or wait in needs_approval until the contract is approved (for at most 24 hours).

Rules the tools follow

This page as Markdown