Skip to content
Puppet logo

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

  1. Run a task on the nodes named in the change
  2. Get a job to check the result
  3. Update the change request in ServiceNow

With ServiceNow

Post failed Puppet job events to Slack

When

On a schedule

Then

  1. List jobs from the last hour
  2. List job events for failed jobs
  3. Post the failures to the ops channel in Slack

With Slack

Load Puppet job history into Snowflake

When

On a schedule

Then

  1. List jobs since the last run
  2. List job nodes for each job
  3. 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

help.puppet.com/pe/2025.9/topics/api_index.htm

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.

Great — a couple more details

This helps us connect you with the right person. Optional, and you can skip it.