
Connectors / IT · HTTP Connector
Automate Puppet with Tray.ai
Run Puppet on nodes, create a node group and generate an authentication token in Puppet. Connect Puppet to the rest of your IT stack with Tray.ai.
What can you do with Puppet on Tray.ai?
Puppet is infrastructure automation software from Perforce that keeps servers in a defined configuration and runs on-demand tasks, plans, and patching across nodes. Tray.ai connects to Puppet through the HTTP Connector, so your workflows can call the Puppet API alongside the rest of your stack.
- Run a task to restart a service when your monitoring tool raises an alert.
- Run Puppet on nodes after a change is approved in your change management system.
- List job events after a run and attach failures to the ticket in your IT service desk.
- Connects through
- HTTP Connector
- Authentication
- An API key in a request header
- Base URL
- https://{your-puppet-server}:8143/orchestrator/v1
Set it up
Connect Puppet to Tray.ai
Each step uses Puppet's own API details, from its documentation.
Step 1
Save Puppet's API key
Save the key as a Tray.ai authentication. The HTTP Client puts it in the request header, read from $.auth. The key stays out of the workflow and out of the logs.
Step 2
Point the HTTP Client at the API
Add an HTTP Client step and use https://{your-puppet-server}:8143/orchestrator/v1 as the base URL. Or paste a cURL example from Puppet's API docs, and Tray.ai fills in the method, URL, and headers.
Step 3
Start with “List jobs”
It's one of 15 documented actions, under Jobs. The response comes back as data the next step can map into your other apps.
Step 4
Hand it to an AI agent
Wrap “Run Puppet on nodes” and “Run a task” in workflows, and Tray.ai's Agent Gateway for MCP publishes them as governed tools Claude and other AI agents can call.
Workflows to build with Puppet
Each one uses actions and events from Puppet's own API documentation.
Run a Puppet task when a ServiceNow change is approved
When
A change request is approved in ServiceNow
Then
- Run a task on the nodes named in the change
- Get a job to check the result
- Update the change request in ServiceNow
With ServiceNow
Post failed Puppet job events to Slack
When
On a schedule
Then
- List jobs from the last hour
- List job events for failed jobs
- Post the failures to the ops channel in Slack
With Slack
Load Puppet job history into Snowflake
When
On a schedule
Then
- List jobs since the last run
- List job nodes for each job
- Load the results into Snowflake
With Snowflake
Apps you can build on Puppet data
Internal tools your team can build with an AI assistant, each one using Puppet calls from its API documentation.
Job history board
Shows recent orchestrator jobs with node results and events so ops can see what failed and where.
Task run console
Lets an engineer run a Puppet task on chosen nodes, follow its status and stop it if needed.
Node group editor
Shows a node group's settings and lets admins create a new group or update an existing one.
Give your AI agents Puppet tools
Build an MCP server on Puppet in Agent Gateway and choose which actions your agents can call. Every call runs with access control and an audit trail. How Agent Gateway works
- Run Puppet on nodes
- List jobs
- Create a node group
- Generate an authentication token
- Run a task
- Run a plan
- Stop a job
- Get a job
What the Puppet API covers
4 resources and 15 documented actions, each one a call the HTTP Connector can make from a Tray.ai workflow. Connecting it takes a few clicks: here's how.
Orchestrator commands
- Run Puppet on nodes
- Run a task
- Run a plan
- Stop a job
Jobs
- List jobs
- Get a job
- List job nodes
- List job events
Node groups
- Create a node group
- Get a node group
- Update a node group
- Delete a node group
RBAC users and tokens
- Generate an authentication token
- Revoke an authentication token
- List users
Checked against Puppet's own documentation on 2026-10-22
How Tray.ai makes this work
Puppet plugs into the whole Tray.ai platform
Intelligent Integration
Integrate and automate across 12,000+ apps, databases, APIs, and services with visual workflows, error handling, and observability.
Learn more →Agent Builder
Build AI agents that read, write, and take action in Puppet — with guardrails, audit, and human-in-the-loop.
Learn more →Agent Gateway for MCP
Expose Puppet actions as governed MCP tools — observable, rate-limited, authenticated.
Learn more →Tray Helix
Build apps on Puppet data with your AI assistant, then deploy, run, and govern them on Tray.ai.
Learn more →More it apps on Tray.ai
Dedicated connectors and other apps Tray.ai reaches in the same category. See every it connector →
Frequently asked questions
What can a Tray.ai workflow do in Puppet?
+
The Puppet API documents 15 actions across 4 resources (Orchestrator commands, Jobs, Node groups, RBAC users and tokens). For example: Run Puppet on nodes; List jobs; Create a node group. A workflow can make any documented call through the HTTP Connector.
How does Tray.ai authenticate with Puppet?
+
The Puppet API uses an API key in a request header. You save it once as a Tray.ai authentication, and the HTTP Connector adds it to every request.
See Puppet working against your stack.
We'll walk through a tailored demo with your systems plugged in.
Thanks — someone from our team will be in touch soon.