PagerDuty · Capability

PagerDuty API

PagerDuty API. 22 operations. Lead operation: PagerDuty List services. Self-contained Naftiko capability covering one Pagerduty business surface.

Run with Naftiko Pagerduty

What You Can Do

GET
Listservices — PagerDuty List services
/v1/services
POST
Createservice — PagerDuty Create a service
/v1/services
GET
Getservice — PagerDuty Get a service
/v1/services/{id}
DELETE
Deleteservice — PagerDuty Delete a service
/v1/services/{id}
PUT
Updateservice — PagerDuty Update a service
/v1/services/{id}
GET
Listserviceauditrecords — PagerDuty List audit records for a service
/v1/services/{id}/audit/records
POST
Createserviceintegration — PagerDuty Create a new integration
/v1/services/{id}/integrations
PUT
Updateserviceintegration — PagerDuty Update an existing integration
/v1/services/{id}/integrations/{integration-id}
GET
Getserviceintegration — PagerDuty View an integration
/v1/services/{id}/integrations/{integration-id}
GET
Listserviceeventrules — PagerDuty List Service's Event Rules
/v1/services/{id}/rules
POST
Createserviceeventrule — PagerDuty Create an Event Rule on a Service
/v1/services/{id}/rules
POST
Convertserviceeventrulestoeventorchestration — PagerDuty Convert a Service's Event Rules into Event Orchestration Rules
/v1/services/{id}/rules/convert
GET
Getserviceeventrule — PagerDuty Get an Event Rule from a Service
/v1/services/{id}/rules/{rule-id}
PUT
Updateserviceeventrule — PagerDuty Update an Event Rule on a Service
/v1/services/{id}/rules/{rule-id}
DELETE
Deleteserviceeventrule — PagerDuty Delete an Event Rule from a Service
/v1/services/{id}/rules/{rule-id}
GET
Listtags — PagerDuty List tags
/v1/tags
POST
Createtags — PagerDuty Create a tag
/v1/tags
GET
Gettag — PagerDuty Get a tag
/v1/tags/{id}
DELETE
Deletetag — PagerDuty Delete a tag
/v1/tags/{id}
GET
Gettagsbyentitytype — PagerDuty Get connected entities
/v1/tags/{id}/{entity-type}
POST
Createentitytypebyidchangetags — PagerDuty Assign tags
/v1/{entity-type}/{id}/change-tags
GET
Getentitytypebyidtags — PagerDuty Get tags for entities
/v1/{entity-type}/{id}/tags

MCP Tools

pagerduty-list-services

PagerDuty List services

read-only idempotent
pagerduty-create-service

PagerDuty Create a service

pagerduty-get-service

PagerDuty Get a service

read-only idempotent
pagerduty-delete-service

PagerDuty Delete a service

idempotent
pagerduty-update-service

PagerDuty Update a service

idempotent
pagerduty-list-audit-records-service

PagerDuty List audit records for a service

read-only idempotent
pagerduty-create-new-integration

PagerDuty Create a new integration

pagerduty-update-existing-integration

PagerDuty Update an existing integration

idempotent
pagerduty-view-integration

PagerDuty View an integration

read-only idempotent
pagerduty-list-service-s-event-rules

PagerDuty List Service's Event Rules

read-only idempotent
pagerduty-create-event-rule-service

PagerDuty Create an Event Rule on a Service

pagerduty-convert-service-s-event-rules

PagerDuty Convert a Service's Event Rules into Event Orchestration Rules

pagerduty-get-event-rule-service

PagerDuty Get an Event Rule from a Service

read-only idempotent
pagerduty-update-event-rule-service

PagerDuty Update an Event Rule on a Service

idempotent
pagerduty-delete-event-rule-service

PagerDuty Delete an Event Rule from a Service

idempotent
pagerduty-list-tags

PagerDuty List tags

read-only idempotent
pagerduty-create-tag

PagerDuty Create a tag

pagerduty-get-tag

PagerDuty Get a tag

read-only idempotent
pagerduty-delete-tag

PagerDuty Delete a tag

idempotent
pagerduty-get-connected-entities

PagerDuty Get connected entities

read-only idempotent
pagerduty-assign-tags

PagerDuty Assign tags

pagerduty-get-tags-entities

PagerDuty Get tags for entities

read-only idempotent

Capability Spec

pagerduty-general.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: PagerDuty API
  description: 'PagerDuty API. 22 operations. Lead operation: PagerDuty List services. Self-contained Naftiko capability covering
    one Pagerduty business surface.'
  tags:
  - Pagerduty
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PAGERDUTY_API_KEY: PAGERDUTY_API_KEY
capability:
  consumes:
  - type: http
    namespace: pagerduty-general
    baseUri: https://api.pagerduty.com
    description: PagerDuty API business capability. Self-contained, no shared references.
    resources:
    - name: services
      path: /services
      operations:
      - name: listservices
        method: GET
        description: PagerDuty List services
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createservice
        method: POST
        description: PagerDuty Create a service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: services-id
      path: /services/{id}
      operations:
      - name: getservice
        method: GET
        description: PagerDuty Get a service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteservice
        method: DELETE
        description: PagerDuty Delete a service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateservice
        method: PUT
        description: PagerDuty Update a service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: services-id-audit-records
      path: /services/{id}/audit/records
      operations:
      - name: listserviceauditrecords
        method: GET
        description: PagerDuty List audit records for a service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: services-id-integrations
      path: /services/{id}/integrations
      operations:
      - name: createserviceintegration
        method: POST
        description: PagerDuty Create a new integration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: services-id-integrations-integration_id
      path: /services/{id}/integrations/{integration_id}
      operations:
      - name: updateserviceintegration
        method: PUT
        description: PagerDuty Update an existing integration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: getserviceintegration
        method: GET
        description: PagerDuty View an integration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: services-id-rules
      path: /services/{id}/rules
      operations:
      - name: listserviceeventrules
        method: GET
        description: PagerDuty List Service's Event Rules
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createserviceeventrule
        method: POST
        description: PagerDuty Create an Event Rule on a Service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: services-id-rules-convert
      path: /services/{id}/rules/convert
      operations:
      - name: convertserviceeventrulestoeventorchestration
        method: POST
        description: PagerDuty Convert a Service's Event Rules into Event Orchestration Rules
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: services-id-rules-rule_id
      path: /services/{id}/rules/{rule_id}
      operations:
      - name: getserviceeventrule
        method: GET
        description: PagerDuty Get an Event Rule from a Service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateserviceeventrule
        method: PUT
        description: PagerDuty Update an Event Rule on a Service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteserviceeventrule
        method: DELETE
        description: PagerDuty Delete an Event Rule from a Service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: tags
      path: /tags
      operations:
      - name: listtags
        method: GET
        description: PagerDuty List tags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createtags
        method: POST
        description: PagerDuty Create a tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: tags-id
      path: /tags/{id}
      operations:
      - name: gettag
        method: GET
        description: PagerDuty Get a tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletetag
        method: DELETE
        description: PagerDuty Delete a tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: tags-id-entity_type
      path: /tags/{id}/{entity_type}
      operations:
      - name: gettagsbyentitytype
        method: GET
        description: PagerDuty Get connected entities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: entity_type-id-change_tags
      path: /{entity_type}/{id}/change_tags
      operations:
      - name: createentitytypebyidchangetags
        method: POST
        description: PagerDuty Assign tags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: entity_type-id-tags
      path: /{entity_type}/{id}/tags
      operations:
      - name: getentitytypebyidtags
        method: GET
        description: PagerDuty Get tags for entities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.PAGERDUTY_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: pagerduty-general-rest
    port: 8080
    description: REST adapter for PagerDuty API. One Spectral-compliant resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/services
      name: services
      description: REST surface for services.
      operations:
      - method: GET
        name: listservices
        description: PagerDuty List services
        call: pagerduty-general.listservices
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createservice
        description: PagerDuty Create a service
        call: pagerduty-general.createservice
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/services/{id}
      name: services-id
      description: REST surface for services-id.
      operations:
      - method: GET
        name: getservice
        description: PagerDuty Get a service
        call: pagerduty-general.getservice
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteservice
        description: PagerDuty Delete a service
        call: pagerduty-general.deleteservice
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateservice
        description: PagerDuty Update a service
        call: pagerduty-general.updateservice
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/services/{id}/audit/records
      name: services-id-audit-records
      description: REST surface for services-id-audit-records.
      operations:
      - method: GET
        name: listserviceauditrecords
        description: PagerDuty List audit records for a service
        call: pagerduty-general.listserviceauditrecords
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/services/{id}/integrations
      name: services-id-integrations
      description: REST surface for services-id-integrations.
      operations:
      - method: POST
        name: createserviceintegration
        description: PagerDuty Create a new integration
        call: pagerduty-general.createserviceintegration
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/services/{id}/integrations/{integration-id}
      name: services-id-integrations-integration-id
      description: REST surface for services-id-integrations-integration_id.
      operations:
      - method: PUT
        name: updateserviceintegration
        description: PagerDuty Update an existing integration
        call: pagerduty-general.updateserviceintegration
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getserviceintegration
        description: PagerDuty View an integration
        call: pagerduty-general.getserviceintegration
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/services/{id}/rules
      name: services-id-rules
      description: REST surface for services-id-rules.
      operations:
      - method: GET
        name: listserviceeventrules
        description: PagerDuty List Service's Event Rules
        call: pagerduty-general.listserviceeventrules
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createserviceeventrule
        description: PagerDuty Create an Event Rule on a Service
        call: pagerduty-general.createserviceeventrule
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/services/{id}/rules/convert
      name: services-id-rules-convert
      description: REST surface for services-id-rules-convert.
      operations:
      - method: POST
        name: convertserviceeventrulestoeventorchestration
        description: PagerDuty Convert a Service's Event Rules into Event Orchestration Rules
        call: pagerduty-general.convertserviceeventrulestoeventorchestration
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/services/{id}/rules/{rule-id}
      name: services-id-rules-rule-id
      description: REST surface for services-id-rules-rule_id.
      operations:
      - method: GET
        name: getserviceeventrule
        description: PagerDuty Get an Event Rule from a Service
        call: pagerduty-general.getserviceeventrule
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateserviceeventrule
        description: PagerDuty Update an Event Rule on a Service
        call: pagerduty-general.updateserviceeventrule
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteserviceeventrule
        description: PagerDuty Delete an Event Rule from a Service
        call: pagerduty-general.deleteserviceeventrule
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tags
      name: tags
      description: REST surface for tags.
      operations:
      - method: GET
        name: listtags
        description: PagerDuty List tags
        call: pagerduty-general.listtags
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createtags
        description: PagerDuty Create a tag
        call: pagerduty-general.createtags
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tags/{id}
      name: tags-id
      description: REST surface for tags-id.
      operations:
      - method: GET
        name: gettag
        description: PagerDuty Get a tag
        call: pagerduty-general.gettag
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletetag
        description: PagerDuty Delete a tag
        call: pagerduty-general.deletetag
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tags/{id}/{entity-type}
      name: tags-id-entity-type
      description: REST surface for tags-id-entity_type.
      operations:
      - method: GET
        name: gettagsbyentitytype
        description: PagerDuty Get connected entities
        call: pagerduty-general.gettagsbyentitytype
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{entity-type}/{id}/change-tags
      name: entity-type-id-change-tags
      description: REST surface for entity_type-id-change_tags.
      operations:
      - method: POST
        name: createentitytypebyidchangetags
        description: PagerDuty Assign tags
        call: pagerduty-general.createentitytypebyidchangetags
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{entity-type}/{id}/tags
      name: entity-type-id-tags
      description: REST surface for entity_type-id-tags.
      operations:
      - method: GET
        name: getentitytypebyidtags
        description: PagerDuty Get tags for entities
        call: pagerduty-general.getentitytypebyidtags
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: pagerduty-general-mcp
    port: 9090
    transport: http
    description: MCP adapter for PagerDuty API. One tool per consumed operation, routed inline through this capability's consumes
      block.
    tools:
    - name: pagerduty-list-services
      description: PagerDuty List services
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pagerduty-general.listservices
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-create-service
      description: PagerDuty Create a service
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pagerduty-general.createservice
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-get-service
      description: PagerDuty Get a service
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pagerduty-general.getservice
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-delete-service
      description: PagerDuty Delete a service
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: pagerduty-general.deleteservice
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-update-service
      description: PagerDuty Update a service
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: pagerduty-general.updateservice
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-list-audit-records-service
      description: PagerDuty List audit records for a service
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pagerduty-general.listserviceauditrecords
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-create-new-integration
      description: PagerDuty Create a new integration
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pagerduty-general.createserviceintegration
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-update-existing-integration
      description: PagerDuty Update an existing integration
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: pagerduty-general.updateserviceintegration
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-view-integration
      description: PagerDuty View an integration
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pagerduty-general.getserviceintegration
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-list-service-s-event-rules
      description: PagerDuty List Service's Event Rules
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pagerduty-general.listserviceeventrules
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-create-event-rule-service
      description: PagerDuty Create an Event Rule on a Service
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pagerduty-general.createserviceeventrule
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-convert-service-s-event-rules
      description: PagerDuty Convert a Service's Event Rules into Event Orchestration Rules
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pagerduty-general.convertserviceeventrulestoeventorchestration
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-get-event-rule-service
      description: PagerDuty Get an Event Rule from a Service
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pagerduty-general.getserviceeventrule
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-update-event-rule-service
      description: PagerDuty Update an Event Rule on a Service
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: pagerduty-general.updateserviceeventrule
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-delete-event-rule-service
      description: PagerDuty Delete an Event Rule from a Service
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: pagerduty-general.deleteserviceeventrule
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-list-tags
      description: PagerDuty List tags
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pagerduty-general.listtags
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-create-tag
      description: PagerDuty Create a tag
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pagerduty-general.createtags
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-get-tag
      description: PagerDuty Get a tag
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pagerduty-general.gettag
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-delete-tag
      description: PagerDuty Delete a tag
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: pagerduty-general.deletetag
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-get-connected-entities
      description: PagerDuty Get connected entities
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pagerduty-general.gettagsbyentitytype
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-assign-tags
      description: PagerDuty Assign tags
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pagerduty-general.createentitytypebyidchangetags
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: pagerduty-get-tags-entities
      description: PagerDuty Get tags for entities
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pagerduty-general.getentitytypebyidtags
      outputParameters:
      - type: object
        mapping: $.