Integration

Portainer integration

Portainer manages container environments (Docker, Swarm, Kubernetes, Edge) from one place. This integration covers the Portainer control plane: environments and environment groups, stacks and their files and git sources, custom templates, edge groups, edge stacks and edge jobs, registries and their configuration, users, teams and memberships, roles and resource controls, webhooks, settings, backup and system status. The Kubernetes proxy routes are deliberately not included: they tunnel the Kubernetes API itself rather than Portainer's own surface. The host is part of the credential because every install is its own deployment. Authentication is an access token sent in the X-API-KEY header.

Connect Portainer How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Portainer.Built from the 168 Portainer tools below, on the connection you add once.

What you can do with Portainer

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Endpoint, 8 operations

delete_endpointDelete endpointDELETERemove an environment.
endpoint_createEndpoint createPOSTCreate a new environment(endpoint).
endpoint_delete_batch_deprecatedEndpoint delete batch deprecatedDELETERemove multiple environments.
endpoint_group_add_endpointEndpoint group add endpointPUTAdd an environment(endpoint) to an environment(endpoint) group.
endpoint_group_delete_endpointEndpoint group delete endpointDELETERemoves environment(endpoint) from an environment(endpoint) group.
endpoint_inspectEndpoint inspectGETInspect an environment(endpoint).
endpoint_listEndpoint listGETList environments(endpoints).
endpoint_updateEndpoint updatePUTUpdate an environment(endpoint).

File, 7 operations

create_fileCreate filePOSTDeploy a new compose stack from a file.
custom_template_create_fileCustom template create filePOSTCreate a custom template.
custom_template_fileCustom template fileGETGet Template stack file content.
edge_job_create_fileEdge job create filePOSTCreate an EdgeJob from a file.
edge_job_fileEdge job fileGETFetch a file of an EdgeJob.
edge_stack_create_fileEdge stack create filePOSTCreate an EdgeStack from file.
edge_stack_fileEdge stack fileGETFetches the stack file for an EdgeStack.

Registrie, 7 operations

delete_registryDelete registryDELETERemove a registry.
endpoint_registries_listEndpoint registries listGETList Registries on environment.
endpoint_registry_accessEndpoint registry accessPUTupdate registry access for environment.
registry_createRegistry createPOSTCreate a new registry.
registry_inspectRegistry inspectGETInspect a registry.
registry_listRegistry listGETList Registries.
registry_updateRegistry updatePUTUpdate a registry.

Edge group, 5 operations

delete_edge_groupDelete edge groupDELETEDeletes an EdgeGroup.
edge_group_createEdge group createPOSTCreate an EdgeGroup.
edge_group_inspectEdge group inspectGETInspects an EdgeGroup.
edge_group_listEdge group listGETlist EdgeGroups.
edge_group_updateEdge group updatePUTUpdates an EdgeGroup.

Endpoint group, 5 operations

create_endpoint_groupCreate endpoint groupPOSTCreate an Environment(Endpoint) Group.
delete_endpoint_groupDelete endpoint groupDELETERemove an environment(endpoint) group.
endpoint_group_listEndpoint group listGETList Environment(Endpoint) groups.
endpoint_group_updateEndpoint group updatePUTUpdate an environment(endpoint) group.
get_endpoint_groupGet endpoint groupGETInspect an Environment(Endpoint) group.

Helm, 5 operations

delete_helmDelete helmDELETEDelete Helm Release.
get_helmGet helmGETGet a helm release.
helm_installHelm installPOSTInstall Helm Chart.
helm_listHelm listGETList Helm Releases.
helm_repo_searchHelm repo searchGETSearch Helm Charts.

Custom template, 4 operations

custom_template_inspectCustom template inspectGETInspect a custom template.
custom_template_listCustom template listGETList available custom templates.
custom_template_updateCustom template updatePUTUpdate a template.
delete_custom_templateDelete custom templateDELETERemove a template.

Edge job, 4 operations

delete_edge_jobDelete edge jobDELETEDelete an EdgeJob.
edge_job_inspectEdge job inspectGETInspect an EdgeJob.
edge_job_listEdge job listGETFetch EdgeJobs list.
edge_job_updateEdge job updatePUTUpdate an EdgeJob.

Edge stack, 4 operations

delete_edge_stackDelete edge stackDELETEDelete an EdgeStack.
edge_stack_inspectEdge stack inspectGETInspect an EdgeStack.
edge_stack_listEdge stack listGETFetches the list of EdgeStacks.
edge_stack_updateEdge stack updatePUTUpdate an EdgeStack.

Log, 4 operations

create_logCreate logPOSTUpdate the logs collected from an Edge Job.
edge_job_task_logs_inspectEdge job task logs inspectGETFetch the log for a specifc task on an EdgeJob.
edge_job_tasks_clearEdge job tasks clearDELETEClear the log for a specifc task on an EdgeJob.
edge_job_tasks_collectEdge job tasks collectPOSTCollect the log for a specifc task on an EdgeJob.

Repository, 4 operations

create_standalone_repositoryCreate standalone repositoryPOSTDeploy a new compose stack from repository.
create_swarm_repositoryCreate swarm repositoryPOSTDeploy a new swarm stack from a git repository.
custom_template_create_repositoryCustom template create repositoryPOSTCreate a custom template.
edge_stack_create_repositoryEdge stack create repositoryPOSTCreate an EdgeStack from a git repository.

Source, 4 operations

delete_sourceDelete sourceDELETEDelete a source.
get_sourceGet sourceGETGet a GitOps source by ID.
git_ops_sources_listGit ops sources listGETList all GitOps sources.
git_ops_sources_update_gitGit ops sources update gitPUTUpdate a Git source.

String, 4 operations

create_stringCreate stringPOSTDeploy a new compose stack from a text.
custom_template_create_stringCustom template create stringPOSTCreate a custom template.
edge_job_create_stringEdge job create stringPOSTCreate an EdgeJob from a text.
edge_stack_create_stringEdge stack create stringPOSTCreate an EdgeStack from a text.

Webhook, 4 operations

create_webhookCreate webhookPOSTCreate a webhook.
delete_webhookDelete webhookDELETEDelete a webhook.
list_webhooksList webhooksGETList webhooks.
replace_webhookReplace webhookPUTUpdate a webhook.

Repositorie, 3 operations

delete_repositoryDelete repositoryDELETEDelete a users helm repositoryies.
helm_user_repositories_listHelm user repositories listGETList a users helm repositories.
helm_user_repository_createHelm user repository createPOSTCreate a user helm repository.

Resource control, 3 operations

delete_resource_controlDelete resource controlDELETERemove a resource control.
resource_control_createResource control createPOSTCreate a new resource control.
resource_control_updateResource control updatePUTUpdate a resource control.

Setting, 3 operations

endpoint_settings_updateEndpoint settings updatePUTUpdate settings for an environment(endpoint).
settings_inspectSettings inspectGETRetrieve Portainer settings.
settings_updateSettings updatePUTUpdate Portainer settings.

Summary, 3 operations

endpoint_summary_countsEndpoint summary countsGETGet environment summary counts.
git_ops_sources_summaryGit ops sources summaryGETSummarize GitOps source status counts.
git_ops_workflows_summaryGit ops workflows summaryGETSummarize GitOps workflow status counts.

Workflow, 3 operations

get_workflowGet workflowGETGet a GitOps workflow by ID.
git_ops_source_workflows_listGit ops source workflows listGETList the workflows using a GitOps source.
git_ops_workflows_listGit ops workflows listGETList all GitOps workflows.

Stack, 2 operations

delete_stackDelete stackDELETERemove a stack.
get_stackGet stackGETInspect an Edge Stack for an Environment.

Test, 2 operations

git_ops_sources_testGit ops sources testPOSTTest a Git source connection.
git_ops_sources_test_by_idGit ops sources test by idPOSTTest the connection of a stored source.

Acces, 1 operation

git_ops_sources_update_accessGit ops sources update accessPUTUpdate a GitOps source's access control.

Auth, 1 operation

authenticate_userAuthenticate userPOSTAuthenticate.

Backup, 1 operation

backupBackupPOSTCreates an archive with a system data snapshot that could be used to restore the system.

Check, 1 operation

ldapcheckLdapcheckPOSTTest LDAP connectivity.

Configure, 1 operation

registry_configureRegistry configurePOSTConfigures a registry.

Dashboard, 1 operation

docker_dashboardDocker dashboardGETGet counters for the dashboard.

Delete, 1 operation

endpoint_delete_batchEndpoint delete batchPOSTRemove multiple environments.

Dockerhub, 1 operation

endpoint_dockerhub_statusEndpoint dockerhub statusGETfetch docker pull limits.

Forceupdateservice, 1 operation

endpoint_force_update_serviceEndpoint force update servicePUTforce update a docker service.

Git, 1 operation

git_ops_sources_create_gitGit ops sources create gitPOSTCreate a Git source.

Git fetch, 1 operation

custom_template_git_fetchCustom template git fetchPUTFetch the latest config file content based on custom template's git repository configuration.

Gpu, 1 operation

docker_container_gpus_inspectDocker container gpus inspectGETFetch container gpus data.

History, 1 operation

helm_get_historyHelm get historyGETGet a historical list of releases.

Image, 1 operation

docker_images_listDocker images listGETFetch images.

Me, 1 operation

current_user_inspectCurrent user inspectGETInspect the current user user.

Motd, 1 operation

motdMotdGETfetches the message of the day.

Ping, 1 operation

registry_pingRegistry pingPOSTTest registry connection.

Preview, 1 operation

git_operation_repo_file_previewGit operation repo file previewPOSTpreview the content of target file in the git repository.

Public, 1 operation

settings_publicSettings publicGETRetrieve Portainer public settings.

Put, 1 operation

create_putCreate putPOSTUpload a file under a specific path on the file system of an environment (endpoint).

Relation, 1 operation

endpoint_update_relationsEndpoint update relationsPUTUpdate relations for a list of environments.

Restore, 1 operation

restoreRestorePOSTTriggers a system restore using provided backup file.

Role, 1 operation

role_listRole listGETList roles.

Rollback, 1 operation

helm_rollbackHelm rollbackPOSTRollback a helm release.

Snapshot, 1 operation

endpoint_snapshotEndpoint snapshotPOSTSnapshots an environment(endpoint).

Ssl, 1 operation

sslinspectSslinspectGETInspect the ssl settings.

Statu, 1 operation

edge_stack_status_updateEdge stack status updatePUTUpdate an EdgeStack status.

Tag, 1 operation

delete_tagDelete tagDELETERemove a tag.

Task, 1 operation

edge_job_tasks_listEdge job tasks listGETFetch the list of tasks on an EdgeJob.

Team, 1 operation

delete_teamDelete teamDELETERemove a team.

Team membership, 1 operation

delete_team_membershipDelete team membershipDELETERemove a team membership.

User, 1 operation

delete_userDelete userDELETERemove a user.

Showing the first 120 of 168 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Portainer from Claude Code, Cursor or Codex

Connect Portainer in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Portainer operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Portainer

Create your workspace
Sign up free. Nothing to install.
Connect Portainer once
Add your Portainer connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.