Reference

MCP tool reference

The Diakrin tools a coding agent can call, grouped by task.

Deployment
BYOC and self-hosted

Your coding agent acts as you. Tools return only metadata you are permitted to see, never business records or secrets. Set up the connection first with Connect your coding tool.

Apps

ToolUse it to
app.listList the apps you can access
app.readRead an app's requirements by its exact app ID
app.editChange an app's requirements
app.draft.create, app.draft.get, app.draft.list, app.draft.updateSave an app idea as a draft and continue it later
app.start, app.get, app.updateStart, resume and answer a business intake
app.prepareTurn a draft into a real app, ready to build
app.createCreate an app, with optional explicit project grouping
app.accessRead your current permissions on one app
app.request-ownerAsk the people responsible to resolve a setup, policy, budget or access blocker
app.data.readRead what data the app holds in your cloud: sizes and names, never values
app.resources.getRead what the app owns: its database, file area and secret store, their states and the secret names it declares, never values or cloud names
app.secret.request, app.secret.removeName a secret the app needs (with what it is for) and get the link where the app owner or IT enters the value, or remove a name. No tool takes a value
app.intent.start, app.intent.read, app.intent.answerWork through app-specific business questions, bound to one app and your identity
app.audience.read, app.audience.updateRead or change who can open the app
app.login_policyRead the app's effective sign-in policy. Read-only
app.logs.readRead up to one hour of the app's log codes with time, level, request ID and artifact digest. Never message text. Unavailable means unknown, not zero
app.metrics.readRead app metric points. Unavailable until a metric source is connected

app.logs.read and app.metrics.read are listed only when your installation has an app log source. Legacy project.* tools remain for real shared project scopes. Keep the exact app ID across calls.

Build and deliver

ToolUse it to
builder.contextStart delivery work with the app's current context
app.blueprint.saveSave the app's blueprint
app.contractRead the trusted developer contract before coding
integration.request-accessRequest access to company data. A request is not an approved grant
build.start, build.getStart a customer-side build and follow it
plan.preview, plan.getPrepare and read a release plan
plan.reviewRecord an independent review of a plan. Not available to the Builder role
deployment.start, deployment.getStart a deployment and follow it
app.version.save, app.version.getSave changed files as a new version and read its check result
app.source.readRead the app's saved source
source.create, source.attach, source.migrate, source.statusSet up, attach, move and read the app's company source
deployment.previewRecheck access and health, then return a short-lived link to the deployed app
app.preview_link.list, app.preview_link.revokeList or revoke Preview links
app.publish, app.rollbackPublish the latest version, or return to the release that was live before
plan.approvalRead the current approval of a plan
app.lifecycleRequest a reviewed pause, resume, retire, export, upgrade or image rollback

Runtime administration

Available when configured and when you hold current runtime-management authority. See App runtime and technical ownership.

ToolUse it to
runtime.statusRead fresh, stale, blocked or unknown runtime status
runtime.verifyRequest one current observation of the runtime
runtime.settings.get, runtime.settings.saveRead or save the app's company configuration. Saving is a policy change: send confirmPolicyChange: true only after the person has confirmed that specific change
runtime.enrollEnroll the app's runtime
runtime.disableDisable the app's runtime
runtime.revokePermanently revoke installation authority

Company data and connections

ToolUse it to
integration.catalog, integration.connectionsSee available providers and your company's connections
integration.effective-permissionsCheck what the app and you can currently read
integration.request-connection, integration.request-status, integration.request-resumeAsk IT to set up a provider, then follow the request

Discover and diagnose

ToolUse it to
platform.context, diagnostics.readRead who you are, your organizations and the connection state
capability.list, catalog.list, policy.catalogList capabilities, company apps and the policies that can stop an action
approvals.listList open requests waiting for IT
migration.list, migration.get, migration.create, migration.update, migration.accessAssess an existing app for migration. Nothing is migrated by these tools

Launch apps

Use the Company catalog launch action, or company_catalog_launch_app, rather than sharing cached deployment URLs. Launch rechecks current app-use permission, runtime stop or revocation, and fresh authenticated deployment evidence. Catalog visibility does not grant app or source access.

Next stepTroubleshooting and help →