# MCP tool reference

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

Source: https://diakrin.com/docs/mcp-tools

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](/docs/builders).

> Your coding tool lists the exact tools available to you. Tools appear only when they are configured for your organization and your current role permits them.

## 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](/docs/runtime).

| 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.
