AI agent integration

The DALP CLI is the supported interface for AI coding agents. Agents can run dalp commands directly, call DALP through MCP tools, or read generated skill files before a run starts. In every mode, each command uses the authenticated CLI session, the active organisation, and the same DALP permission checks as a manual operator.

Before you give an assistant a DALP task, install the CLI, authenticate it, pin the organisation, and choose the integration mode that matches the runtime. Shell execution is easiest to audit. MCP is safer when typed tool calls are available. Skill files teach the command surface before work starts.

Integration modes

Use shell execution for transparent logs. Use MCP when typed tool calls reduce parsing risk. Use skills for local command guidance while the agent prepares work. You can combine all three modes in the same workspace: skills explain the CLI surface, MCP exposes tools, and shell commands remain available for explicit checks.

Set up a development workspace

Set up the workspace in this order so the assistant can show the starting state before any DALP operation. The sequence also gives reviewers predictable evidence: CLI version, authenticated account, selected organisation, and machine-readable output.

1. Install and authenticate

npm install -g @settlemint/dalp-cli
dalp login --url https://your-platform.example.com

Then check the authenticated account at the start of the run:

dalp whoami --format json

This gives the assistant a concrete account and tenant record to quote back before any platform operation. If the output is missing or unexpected, fix authentication before continuing.

2. Set the tenant context

If your account can access more than one tenant, list the available organisations and switch explicitly.

dalp auth org-list --format json
dalp auth org-switch <organizationId> --format json

dalp auth org-switch requires an organisation ID. Do not rely on an agent to guess the target organisation from natural language.

3. Prefer JSON output for shell agents

dalp config set format json

Agents should parse JSON fields rather than terminal tables. For one-off commands, you can also pass --format json directly.

4. Register MCP and skills when supported

# Register the CLI as an MCP server for supported local agents.
dalp mcp add

# Install generated DALP skill files for agent discovery.
dalp skills add

# Confirm the installed DALP skills.
dalp skills list

dalp mcp and dalp skills are local setup commands. They can run before authentication, but DALP platform operations still require a valid login and the required roles.

MCP server integration

The DALP CLI includes a built-in MCP registration command:

dalp mcp add

Use this as the default setup path. The CLI registers itself as an MCP server for supported local agents, then exposes DALP commands as assistant tools.

If you maintain MCP settings manually, run the DALP CLI in MCP mode:

{
  "mcpServers": {
    "dalp": {
      "command": "dalp",
      "args": ["--mcp"]
    }
  }
}

Keep authentication in the CLI session or approved environment configuration. Do not put API keys, private keys, or customer secrets in the MCP settings file.

Skill integration

The CLI can sync generated skill files for agents that read local Markdown instructions.

dalp skills add
dalp skills list

Skills use CLI metadata to describe arguments, options, output formats, and examples. They guide the assistant; they are not a security boundary.

You can inspect the same metadata directly when you want to review the generated guidance:

# LLM-readable command manifest
dalp --llms

# JSON Schema for command metadata
dalp --schema

Use this output when you want to check names, options, and examples without opening the full command reference. The manifest helps you review generated guidance before handing over a narrow task.

Safe agent patterns

Inspect before mutate

Ask the agent to query current state first, then propose the exact mutation command for review.

# 1. Inspect the token.
dalp tokens read <tokenAddress> --format json

# 2. Inspect account roles before asking the agent to prepare privileged actions.
dalp system access-manager roles-list --format json

Make retries idempotent

Use list-before-create or read-before-update patterns. Agents should not retry a mutation blindly after a timeout.

existing=$(dalp tokens list --format json | jq '.data[]? | select(.symbol == "MTK")')
if [ -z "$existing" ]; then
  dalp tokens create --type equity --name "My Token" --symbol MTK --decimals 18 --countryCode 840 --format json
fi

Preserve organisation scope

Pin the organisation at the start of the run and include it in the agent's working notes.

dalp auth org-list --format json
dalp auth org-switch <organizationId> --format json
dalp whoami --format json

Handle structured errors

Agents should check exit codes and read the structured error body before retrying or escalating.

result=$(dalp tokens read <tokenAddress> --format json 2>&1) || {
  echo "$result" | jq -r '.message // .error // .'
  exit 1
}

If a check fails, stop the run and fix the setup. Do not continue from guessed state or ask the agent to infer missing organisation, role, or token information.

Security considerations

• Agents inherit the authenticated CLI account. Limit that account with DALP roles instead of relying on prompt instructions.
• Operations are scoped to the active organisation. Switch explicitly with dalp auth org-switch <organizationId>.
• dalp mcp add and dalp skills add configure the local agent environment; they do not grant platform access by themselves.
• Keep credentials in the CLI-supported login flow or approved environment configuration. Do not paste secrets into agent prompts, skill files, or MCP JSON.
• Require a human review step for privileged operations such as minting, pausing, role changes, compliance changes, and identity approval.
• Store operational evidence from DALP command output and platform records, not from the assistant's narrative summary alone.

Command checks

Use these commands to verify the agent workspace before a DALP run:

dalp --version
dalp whoami --format json
dalp auth org-list --format json
dalp system access-manager roles-list --format json
dalp mcp --help
dalp skills --help

Next steps

• Use the command reference to confirm command names and options.
• Read CLI scripting for shell automation patterns.
• Review the AI assistants overview for operator-facing controls and usage examples.