πŸš€ PagerDuty AI Agent

by cnoe-io

234 downloads Not rated yet Apache-2.0 license
GitHub

About

PagerDuty AI Agent powered by 1st Party MCP Server using OpenAPI Codegen, LangGraph and LangChain MCP Adapters. Agent is exposed on various agent transport protocols (AGNTCY ACP, Google A2A, MCP Server)Agent for PagerDuty

Details

License
Apache-2.0 license

Explore

- πŸ€– LangGraph + LangChain MCP Adapter for agent orchestration
- 🧠 Azure OpenAI GPT-4 as the LLM backend
- πŸ”— Connects to PagerDuty via a dedicated PagerDuty MCP agent
- πŸ”„ Multi-protocol support: Compatible with both ACP and A2A protocols for flexible integration and multi-agent orchestration
- πŸ“Š Comprehensive PagerDuty API Support:
- Incident Management (create, update, resolve)
- Service Management
- Schedule Management
- Team Management
- User Management
- Escalation Policy Management

---

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name πŸš€ PagerDuty AI Agent
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Running it via Docker:

Ensure your .env file is set up as described in the cnoe-agent-utils usage guide based on your LLM Provider.

Example .env configuration:

############################

############################
LLM_PROVIDER=azure-openai
AGENT_NAME=pagerduty

############################

############################
AZURE_OPENAI_API_KEY=<your-azure-key>
AZURE_OPENAI_API_VERSION=2025-04-01-preview
AZURE_OPENAI_DEPLOYMENT=gpt-4.1
AZURE_OPENAI_ENDPOINT=<your-azure-endpoint>

############################

############################
PAGERDUTY_API_KEY=<your-pagerduty-key>
PAGERDUTY_API_URL=https://api.pagerduty.com

You can also run the agent locally without Docker:

First clone the repo

git clone https://github.com/cnoe-io/agent-pagerduty.git
cd agent-pagerduty
make run-a2a

In a new terminal, start the A2A client:

make run-a2a-client

1. Create a PagerDuty Account:
If you don't have one, sign up at PagerDuty.

2. Generate an API Key:
- Log in to your PagerDuty account
- Go to Configuration β†’ API Access
- Create a new API key with appropriate permissions
- Save the API key securely

3. Get Your PagerDuty Domain:
- Your API URL will be https://api.pagerduty.com
- Update the PAGERDUTY_API_URL in your .env file

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "\ud83d\ude80 pagerduty ai agent": {
            "agent-pagerduty": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/cnoe-io/agent-pagerduty:a2a-latest"
                ]
            }
        }
    }
}

McpServers

{
    "agent-pagerduty": {
        "command": "docker",
        "args": [
            "pull",
            "ghcr.io/cnoe-io/agent-pagerduty:a2a-latest"
        ]
    }
}

Python
Poetry
License

Conventional Commits
Ruff Linter
Super Linter
Unit Tests

A2A Docker Build and Push
---

πŸ§ͺ Evaluation Badges

| Claude | Gemini | OpenAI | Llama |
|--------|--------|--------|-------|
| Claude Evals | Gemini Evals | OpenAI Evals | Llama Evals |

---

- πŸ€– PagerDuty Agent is an LLM-powered agent built using the LangGraph ReAct Agent workflow and MCP tools.
- 🌐 Protocol Support: Compatible with ACP and A2A protocols for integration with external user clients.
- πŸ›‘οΈ Secure by Design: Enforces PagerDuty API token-based authentication and supports external authentication for strong access control.
- πŸ”Œ Integrated Communication: Uses langchain-mcp-adapters to connect with the PagerDuty MCP server within the LangGraph ReAct Agent workflow.
- 🏭 First-Party MCP Server: The MCP server is generated by our first-party openapi-mcp-codegen utility, ensuring version/API compatibility and software supply chain integrity.

---

πŸš€ Getting Started

Running it via Docker:

1️⃣ Configure Environment

Ensure your .env file is set up as described in the cnoe-agent-utils usage guide based on your LLM Provider.

Example .env configuration:
```env
############################

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.