Reference
MCP tool reference
The Diakrin tools a coding agent can call, grouped by task.
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
| Tool | Use it to |
|---|---|
app.list | List the apps you can access |
app.read | Read an app's requirements by its exact app ID |
app.edit | Change an app's requirements |
app.draft.create, app.draft.get, app.draft.list, app.draft.update | Save an app idea as a draft and continue it later |
app.start, app.get, app.update | Start, resume and answer a business intake |
app.prepare | Turn a draft into a real app, ready to build |
app.create | Create an app, with optional explicit project grouping |
app.access | Read your current permissions on one app |
app.request-owner | Ask the people responsible to resolve a setup, policy, budget or access blocker |
app.data.read | Read what data the app holds in your cloud: sizes and names, never values |
app.resources.get | Read 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.remove | Name 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.answer | Work through app-specific business questions, bound to one app and your identity |
app.audience.read, app.audience.update | Read or change who can open the app |
app.login_policy | Read the app's effective sign-in policy. Read-only |
app.logs.read | Read 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.read | Read 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
| Tool | Use it to |
|---|---|
builder.context | Start delivery work with the app's current context |
app.blueprint.save | Save the app's blueprint |
app.contract | Read the trusted developer contract before coding |
integration.request-access | Request access to company data. A request is not an approved grant |
build.start, build.get | Start a customer-side build and follow it |
plan.preview, plan.get | Prepare and read a release plan |
plan.review | Record an independent review of a plan. Not available to the Builder role |
deployment.start, deployment.get | Start a deployment and follow it |
app.version.save, app.version.get | Save changed files as a new version and read its check result |
app.source.read | Read the app's saved source |
source.create, source.attach, source.migrate, source.status | Set up, attach, move and read the app's company source |
deployment.preview | Recheck access and health, then return a short-lived link to the deployed app |
app.preview_link.list, app.preview_link.revoke | List or revoke Preview links |
app.publish, app.rollback | Publish the latest version, or return to the release that was live before |
plan.approval | Read the current approval of a plan |
app.lifecycle | Request 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.
| Tool | Use it to |
|---|---|
runtime.status | Read fresh, stale, blocked or unknown runtime status |
runtime.verify | Request one current observation of the runtime |
runtime.settings.get, runtime.settings.save | Read 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.enroll | Enroll the app's runtime |
runtime.disable | Disable the app's runtime |
runtime.revoke | Permanently revoke installation authority |
Company data and connections
| Tool | Use it to |
|---|---|
integration.catalog, integration.connections | See available providers and your company's connections |
integration.effective-permissions | Check what the app and you can currently read |
integration.request-connection, integration.request-status, integration.request-resume | Ask IT to set up a provider, then follow the request |
Discover and diagnose
| Tool | Use it to |
|---|---|
platform.context, diagnostics.read | Read who you are, your organizations and the connection state |
capability.list, catalog.list, policy.catalog | List capabilities, company apps and the policies that can stop an action |
approvals.list | List open requests waiting for IT |
migration.list, migration.get, migration.create, migration.update, migration.access | Assess 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.