cyberneticlibrary

Optimize Portainer MCP query patterns

portainer-mcp-hygieneskillsetup L1171
portainer/portainer-mcp
What it does

Project Portainer MCP payloads via JMESPath to reduce truncation

Best for

Large Portainer queries where 20K+ tokens of unneeded data would waste context.

Inputs
  • · JMESPath select expression
  • · tool name
Outputs
  • · filtered JSON response
Requires
  • · portainer-mcp tools (docker_proxy, kubernetes_proxy, EndpointList, etc)
Preconditions

Portainer environment reachable, response may exceed 50K chars

Failure modes

Unquoted composite keys fail silently, wrong environment_id raises 404, projection misses needed fields

Trust signals
  • · environment resolution pattern
  • · quoted identifier syntax
  • · Snapshots/managedFields exclusion rules