Rumatadocs
Browse documentation

Tool catalog

Every Rumata capability by name: the native tool on a development machine and the matching public MCP tool or operation.

Step-by-step guidance.

Before you start

  • A connected Rumata MCP server. Tool schemas come from the server; this page tells you which one to use.

How names work

  • Native agents see tools named `rumata.<name>`, although a client can show them with another prefix. Use the name your client advertises.
  • External clients see public tools such as `get_operation`. `rumata.*` names are search terms there, not callable aliases.
  • Website actions have operation IDs such as `api:POST:/project/backend-services`. Find them with `search_operations`, read them with `get_operation`, and run them with `call_operation`.

Knowledge

NeedNativePublic MCP
Find a documentation section`rumata.searchDocs``search_docs`
Read a guide or one section`rumata.readDoc``read_doc`
Load guidance on how to workSkills`list_skills`, `read_skill`
Read this factory’s context`rumata.getFactoryBuilderContext``get_project_context`

Backends

NeedNativePublic MCP operation
List services`rumata.listBackendServices``api:GET:/project/backend-services`, with query `projectId` and `factoryId`
Read a service`rumata.getBackendService``api:GET:/project/backend-services/:id`
Create or update`rumata.configureBackendService``api:POST:/project/backend-services`, `api:PUT:/project/backend-services/:id`
Ensure development`rumata.runBackendServiceAction` `ensureDevelopment``api:PUT:/project/backend-services/:id/development`
Stop development`rumata.runBackendServiceAction` `stopDevelopment``api:DELETE:/project/backend-services/:id/development`
Build`rumata.runBackendServiceAction` `build``api:POST:/project/backend-services/:id/build`
Deploy`rumata.runBackendServiceAction` `deploy``api:POST:/project/backend-services/:id/deploy`
Unpublish`rumata.runBackendServiceAction` `unpublish``api:POST:/project/backend-services/:id/unpublish`
Build logs`rumata.getBackendBuildLogs``api:GET:/project/backend-services/:id/builds/:buildId/logs`
Test a route`rumata.debugBackendRequest``debug_backend_request`
Disks`rumata.getBackendDisk`, `rumata.createBackendDisk`, `rumata.growBackendDisk`, `rumata.deleteBackendDisk`Search `backend disk`

Data and files

NeedNativePublic MCP operation
Run setup SQL`rumata.executeSql``workflow:POST:/api-gateway/execute-sql-query`, then poll the run ID
Saved queries`rumata.searchDatabaseQueries`, `rumata.createDatabaseQuery`, `rumata.getDatabaseQuery`, `rumata.updateDatabaseQuery`, `rumata.executeDatabaseQuery`Search `database query`
Extensions`rumata.listDatabaseExtensions`, `rumata.setDatabaseExtension``PUT /project/hosted-database/{projectId}/extensions/{name}`
Provision the databaseAutomatic`kondor:POST:/factory/ensure-database-provisioned`, `kondor:GET:/factory/database-connection-id` with query `_factory_id`
Storage ID`rumata.getFactoryBuilderContext``api:GET:/project/storage/metadata`. A new factory has no storage until `api:POST:/api-keys/provision` creates it.
Sign an uploadBackend storage API`api:GET:/project/storage/:projectStorageId/object/upload-url`
List filesBackend storage API`api:GET:/project/storage/:projectStorageId/objects`
Sign downloadsBackend storage API`api:POST:/project/storage/:projectStorageId/presign`

Workflows and integrations

NeedNativePublic MCP operation
Find`rumata.searchWorkflows`, `rumata.getWorkflow`Search `workflow`
Create and change`rumata.createWorkflow`, `rumata.updateWorkflow`, `rumata.deleteWorkflow``api:POST:/project/workFlow/graph/new`
Debug a draft`rumata.debugWorkflowRequest``api:POST:/project/workFlow/graph/:id/run`
Versions and runs`rumata.getWorkflowVersions`, `rumata.getWorkflowRuns``api:GET:/project/workFlow/graph/:id/version`
Publish privately`rumata.publishIntegrationWorkflow``api:POST:/project/workFlow/graph/:id/deployment`
Schemas`rumata.syncWorkflowSchemas`, `rumata.updateWorkflowOutputSchema`Search `workflow schema`
Schedules`rumata.getWorkflowSchedule`, `rumata.syncWorkflowSchedule`, `rumata.setWorkflowSchedulePaused`Search `workflow schedule`
Backend access`rumata.getWorkflowBackendAccess`, `rumata.repairWorkflowBackendAccess``api:POST:/project/workFlow/graph/:id/integration-access`
Connectors`rumata.listConnectors`Search `connector`
Secrets`rumata.listSecrets`, `rumata_requestSecrets``get_secret_setup`
API keys`rumata.provisionApiKey`, `rumata.listApiKeys`, `rumata.revokeApiKey``api:POST:/api-keys/provision`, with `name`, `projectId`, `factoryId` and `expiresAt`
Groups`rumata.listUserGroups`, `rumata.createUserGroup`, `rumata.grantGroupAccess`Search `user group`. `user-group/permissions/new` is blocked; use integration access.

Activities

NeedNativePublic MCP
Find`rumata.searchActivities`, `rumata.getActivity`Search `activity`
Create from Git`rumata.createActivityFromGit`Search `activity git`
Rebuild`rumata.buildActivityFromGit`, `rumata.getActivityBuild`Search `activity build`
Deploy`rumata.deployActivityRealtime`, `rumata.undeployActivityRealtime`, `rumata.getActivityDeployment`Search `activity deployment`

Frontend, machine and browser

NeedNativePublic MCP
Activate the frontend`rumata.enableFrontend``get_machine_status`, then `enable_frontend`
Publish the website`rumata.getFrontendDeployment`, `rumata.publishFrontend``api:POST:/project/frontend/deploy`
Read and write sourceLocal files`machine:GET:/opencode/file/content`, `machine:POST:/workspace/upload`, `kondor:GET:/git/files`
Run a commandLocal shell`machine:POST:/exec`, with `body.cwd`. Check the exit code; HTTP success can carry a failed command.
Browser`preview_navigate`, `preview_click`, `preview_evaluate`, `preview_set_viewport`, `get_runtime_errors``machine:POST:/browser/tools` lists and calls the same tools
Delegate to an agentNot applicable`start_coding_task`, `read_coding_task`, `send_coding_message`, `stop_coding_task`