Application Tools Overview

Complete reference for all 26 application management tools in Dokploy MCP Server

The Application Tools group provides comprehensive application lifecycle management capabilities in Dokploy. These tools enable you to create, configure, deploy, and monitor applications across your infrastructure.

Tool Categories

The 26 application tools are organized into four functional categories:

Core Operations (12 tools)

Manage the fundamental lifecycle of applications:

• application-one - Retrieve application details by ID
• application-create - Create new applications
• application-update - Update application configuration
• application-delete - Delete applications
• application-deploy - Deploy applications
• application-redeploy - Redeploy applications
• application-start - Start applications
• application-stop - Stop applications
• application-reload - Reload applications
• application-move - Move applications between projects
• application-markRunning - Mark applications as running
• application-cancelDeployment - Cancel ongoing deployments

Git Provider Configuration (6 tools)

Configure source code providers for applications:

• application-saveGithubProvider - Configure GitHub integration
• application-saveGitlabProvider - Configure GitLab integration
• application-saveBitbucketProvider - Configure Bitbucket integration
• application-saveGiteaProvider - Configure Gitea integration
• application-saveGitProvider - Configure custom Git provider
• application-disconnectGitProvider - Disconnect Git provider

Configuration Management (8 tools)

Manage build, environment, and runtime configuration:

• application-saveBuildType - Configure build type and settings
• application-saveEnvironment - Save environment variables
• application-saveDockerProvider - Configure Docker image source
• application-readAppMonitoring - Read monitoring metrics
• application-readTraefikConfig - Read Traefik configuration
• application-updateTraefikConfig - Update Traefik configuration
• application-refreshToken - Refresh application token
• application-cleanQueues - Clean deployment queues

Semantic Annotations

All application tools include semantic hints to help MCP clients understand their behavior:

• Read-Only Operations: application-one, application-readAppMonitoring, application-readTraefikConfig
• Destructive Operations: application-update, application-delete, application-stop, application-cancelDeployment, all configuration save operations
• Non-Destructive Operations: application-create, application-deploy, application-start, application-reload
• Idempotent Operations: All read-only operations

Quick Start Example

Here’s a typical workflow for creating and deploying an application:

// 1. Create the application
{
  "tool": "application-create",
  "input": {
    "name": "my-web-app",
    "appName": "my-web-app",
    "description": "Production web application",
    "environmentId": "env_123"
  }
}

// 2. Configure GitHub integration
{
  "tool": "application-saveGithubProvider",
  "input": {
    "applicationId": "app_456",
    "owner": "myorg",
    "repository": "myorg/web-app",
    "branch": "main",
    "githubId": "gh_789",
    "enableSubmodules": false
  }
}

// 3. Configure build settings
{
  "tool": "application-saveBuildType",
  "input": {
    "applicationId": "app_456",
    "buildType": "dockerfile",
    "dockerContextPath": null,
    "dockerBuildStage": null
  }
}

// 4. Deploy the application
{
  "tool": "application-deploy",
  "input": {
    "applicationId": "app_456"
  }
}

Next Steps

Explore the detailed documentation for each category:

• Core Operations - CRUD and lifecycle management
• Git Providers - Source code integration
• Configuration - Build, environment, and runtime settings