Gremlin · Capability

Gremlin API — reports

Gremlin API — reports. 21 operations. Lead operation: Loads the Attacks Summary for the specified time period.. Self-contained Naftiko capability covering one Gremlin business surface.

Run with Naftiko Gremlinreports

What You Can Do

GET
Attacksummary — Loads the Attacks Summary for the specified time period.
/v1/reports/attacks
GET
Clientsummary — Loads the Client Summary for the specified time period.
/v1/reports/clients
GET
Companysummary — Loads the Company Summary for the specified month.
/v1/reports/companies
GET
Companysummarypdf — Loads the Company Summary PDF for the specified time frame.
/v1/reports/companies/pdf
GET
Getcompanyreliabilitymanagementreport — Loads the Company Reliability Management Report for the specified time window defaulting to a week.
/v1/reports/companies/reliability-management
GET
Getcompanyreliabilitymanagementreportgrouped — Loads the Company Reliability Management Report grouped by query param value of groupBy - defaults to TEAM.
/v1/reports/companies/reliability-management/grouped
GET
Getcompanyreliabilitymanagementreport1 — Loads the company service list and reliability trend for each service for the specified time window defaulting to a month.
/v1/reports/companies/reliability-management/services
GET
Getcompanyscorerisktrends — Returns the Risk and Score trends for your company across all associated services
/v1/reports/companies/trends
GET
Pricingreport — Loads the pricing usage for the specified dates and tracking period.
/v1/reports/pricing
GET
Getreliabilityreporttrendforallservicesofteam — Loads the Reliability report trend for all the services of the team for the specified time period defaulting to 1 months and 4 data points
/v1/reports/services/reliability-management/reliability-report-trend
GET
Getreliabilityreporttrendforservice — Loads the Reliability report trend for the service for the specified time period defaulting to 1 months and 4 data points
/v1/reports/services/{serviceid}/reliability-management/reliability-report-trend
GET
Getdetectedrisksreporttrendforteam — Returns the trend of risks across all services for a given team
/v1/reports/team/detected-risk/trend
GET
Getriskevaluationreportforteam — Loads latest risk evaluation for each eligible service for the team
/v1/reports/team/detected-risks-report
GET
Getriskevaluationreportforteampdf — Loads the team risk report PDF for the specified time frame.
/v1/reports/team/detected-risks-report/pdf
GET
Getreliabilityreportforteam — Requires the privilege [`RELIABILITY_REPORTS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)
/v1/reports/team/reliability-report
GET
Getreliabilityreportforteampdf — Loads the team reliability report PDF for the specified time frame.
/v1/reports/team/reliability-report/pdf
GET
Getreliabilityreporttrendforteam — Returns the trend of Reliability Scores across all services for a given team
/v1/reports/team/reliability-report/trend
GET
Getscorerisktrendsforteam — Returns the trend of Reliability Scores across all services for a given team
/v1/reports/team/trends
GET
Teamsummaries — This functionality has moved to GET /reports/teams/paged.Loads the Team Summary for the specified month.
/v1/reports/teams
GET
Teamsummariespaged — Loads the Team Summary for the specified month.
/v1/reports/teams/paged
GET
Usersummary — Loads the User Summary for the specified time period.
/v1/reports/users

MCP Tools

loads-attacks-summary-specified-time

Loads the Attacks Summary for the specified time period.

read-only idempotent
loads-client-summary-specified-time

Loads the Client Summary for the specified time period.

read-only idempotent
loads-company-summary-specified-month

Loads the Company Summary for the specified month.

read-only idempotent
loads-company-summary-pdf-specified

Loads the Company Summary PDF for the specified time frame.

read-only idempotent
loads-company-reliability-management-report

Loads the Company Reliability Management Report for the specified time window defaulting to a week.

read-only idempotent
loads-company-reliability-management-report-2

Loads the Company Reliability Management Report grouped by query param value of groupBy - defaults to TEAM.

read-only idempotent
loads-company-service-list-and

Loads the company service list and reliability trend for each service for the specified time window defaulting to a month.

read-only idempotent
returns-risk-and-score-trends

Returns the Risk and Score trends for your company across all associated services

read-only idempotent
loads-pricing-usage-specified-dates

Loads the pricing usage for the specified dates and tracking period.

read-only idempotent
loads-reliability-report-trend-all

Loads the Reliability report trend for all the services of the team for the specified time period defaulting to 1 months and 4 data points

read-only idempotent
loads-reliability-report-trend-service

Loads the Reliability report trend for the service for the specified time period defaulting to 1 months and 4 data points

read-only idempotent
returns-trend-risks-across-all

Returns the trend of risks across all services for a given team

read-only idempotent
loads-latest-risk-evaluation-each

Loads latest risk evaluation for each eligible service for the team

read-only idempotent
loads-team-risk-report-pdf

Loads the team risk report PDF for the specified time frame.

read-only idempotent
requires-privilege-reliability-reports-read-https

Requires the privilege [`RELIABILITY_REPORTS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

read-only idempotent
loads-team-reliability-report-pdf

Loads the team reliability report PDF for the specified time frame.

read-only idempotent
returns-trend-reliability-scores-across

Returns the trend of Reliability Scores across all services for a given team

read-only idempotent
returns-trend-reliability-scores-across-2

Returns the trend of Reliability Scores across all services for a given team

read-only idempotent
this-functionality-has-moved-get

This functionality has moved to GET /reports/teams/paged.Loads the Team Summary for the specified month.

read-only idempotent
loads-team-summary-specified-month

Loads the Team Summary for the specified month.

read-only idempotent
loads-user-summary-specified-time

Loads the User Summary for the specified time period.

read-only idempotent

Capability Spec

gremlin-reports.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: Gremlin API — reports
  description: 'Gremlin API — reports. 21 operations. Lead operation: Loads the Attacks Summary for the specified time period..
    Self-contained Naftiko capability covering one Gremlin business surface.'
  tags:
  - Gremlin
  - reports
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GREMLIN_API_KEY: GREMLIN_API_KEY
capability:
  consumes:
  - type: http
    namespace: gremlin-reports
    baseUri: https://api.gremlin.com/v1
    description: Gremlin API — reports business capability. Self-contained, no shared references.
    resources:
    - name: reports-attacks
      path: /reports/attacks
      operations:
      - name: attacksummary
        method: GET
        description: Loads the Attacks Summary for the specified time period.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
          description: team identifier associated with the requester's team
          required: true
        - name: start
          in: query
          type: string
          required: true
        - name: end
          in: query
          type: string
          required: true
        - name: period
          in: query
          type: string
          required: true
    - name: reports-clients
      path: /reports/clients
      operations:
      - name: clientsummary
        method: GET
        description: Loads the Client Summary for the specified time period.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
          description: team identifier associated with the requester's team
          required: true
        - name: start
          in: query
          type: string
          required: true
        - name: end
          in: query
          type: string
          required: true
        - name: period
          in: query
          type: string
          required: true
    - name: reports-companies
      path: /reports/companies
      operations:
      - name: companysummary
        method: GET
        description: Loads the Company Summary for the specified month.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startDate
          in: query
          type: string
          required: true
        - name: endDate
          in: query
          type: string
          required: true
    - name: reports-companies-pdf
      path: /reports/companies/pdf
      operations:
      - name: companysummarypdf
        method: GET
        description: Loads the Company Summary PDF for the specified time frame.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
        - name: topN
          in: query
          type: integer
        - name: filter
          in: query
          type: string
        - name: groupBy
          in: query
          type: string
    - name: reports-companies-reliability-management
      path: /reports/companies/reliability-management
      operations:
      - name: getcompanyreliabilitymanagementreport
        method: GET
        description: Loads the Company Reliability Management Report for the specified time window defaulting to a week.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: topN
          in: query
          type: integer
        - name: includeDailyReport
          in: query
          type: boolean
    - name: reports-companies-reliability-management-grouped
      path: /reports/companies/reliability-management/grouped
      operations:
      - name: getcompanyreliabilitymanagementreportgrouped
        method: GET
        description: Loads the Company Reliability Management Report grouped by query param value of groupBy - defaults to
          TEAM.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: groupBy
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
        - name: filter
          in: query
          type: string
    - name: reports-companies-reliability-management-services
      path: /reports/companies/reliability-management/services
      operations:
      - name: getcompanyreliabilitymanagementreport1
        method: GET
        description: Loads the company service list and reliability trend for each service for the specified time window defaulting
          to a month.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
        - name: topN
          in: query
          type: integer
        - name: filter
          in: query
          type: string
    - name: reports-companies-trends
      path: /reports/companies/trends
      operations:
      - name: getcompanyscorerisktrends
        method: GET
        description: Returns the Risk and Score trends for your company across all associated services
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
        - name: filter
          in: query
          type: string
    - name: reports-pricing
      path: /reports/pricing
      operations:
      - name: pricingreport
        method: GET
        description: Loads the pricing usage for the specified dates and tracking period.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startDate
          in: query
          type: string
          description: Start date (yyyy-mm-dd) for the pricing usage. Should be within the current contract duration
          required: true
        - name: endDate
          in: query
          type: string
          description: End date (yyyy-mm-dd) for the pricing usage. Should be within the current contract duration
          required: true
        - name: trackingPeriod
          in: query
          type: string
          description: Tracking period for the pricing usage. Should be either Daily, Weekly or Monthly based on the contract.
            Defaults to the currently configured period for the comp
    - name: reports-services-reliability-management-reliability-report-trend
      path: /reports/services/reliability-management/reliability-report-trend
      operations:
      - name: getreliabilityreporttrendforallservicesofteam
        method: GET
        description: Loads the Reliability report trend for all the services of the team for the specified time period defaulting
          to 1 months and 4 data points
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
    - name: reports-services-serviceId-reliability-management-reliability-report-trend
      path: /reports/services/{serviceId}/reliability-management/reliability-report-trend
      operations:
      - name: getreliabilityreporttrendforservice
        method: GET
        description: Loads the Reliability report trend for the service for the specified time period defaulting to 1 months
          and 4 data points
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: serviceId
          in: path
          type: string
          required: true
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
    - name: reports-team-detected-risk-trend
      path: /reports/team/detected-risk/trend
      operations:
      - name: getdetectedrisksreporttrendforteam
        method: GET
        description: Returns the trend of risks across all services for a given team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
    - name: reports-team-detected-risks-report
      path: /reports/team/detected-risks-report
      operations:
      - name: getriskevaluationreportforteam
        method: GET
        description: Loads latest risk evaluation for each eligible service for the team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
    - name: reports-team-detected-risks-report-pdf
      path: /reports/team/detected-risks-report/pdf
      operations:
      - name: getriskevaluationreportforteampdf
        method: GET
        description: Loads the team risk report PDF for the specified time frame.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
          required: true
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
    - name: reports-team-reliability-report
      path: /reports/team/reliability-report
      operations:
      - name: getreliabilityreportforteam
        method: GET
        description: Requires the privilege [`RELIABILITY_REPORTS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
    - name: reports-team-reliability-report-pdf
      path: /reports/team/reliability-report/pdf
      operations:
      - name: getreliabilityreportforteampdf
        method: GET
        description: Loads the team reliability report PDF for the specified time frame.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
          required: true
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
    - name: reports-team-reliability-report-trend
      path: /reports/team/reliability-report/trend
      operations:
      - name: getreliabilityreporttrendforteam
        method: GET
        description: Returns the trend of Reliability Scores across all services for a given team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
    - name: reports-team-trends
      path: /reports/team/trends
      operations:
      - name: getscorerisktrendsforteam
        method: GET
        description: Returns the trend of Reliability Scores across all services for a given team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: numberOfDataPoints
          in: query
          type: integer
    - name: reports-teams
      path: /reports/teams
      operations:
      - name: teamsummaries
        method: GET
        description: This functionality has moved to GET /reports/teams/paged.Loads the Team Summary for the specified month.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startDate
          in: query
          type: string
          required: true
        - name: endDate
          in: query
          type: string
          required: true
        - name: teamId
          in: query
          type: string
    - name: reports-teams-paged
      path: /reports/teams/paged
      operations:
      - name: teamsummariespaged
        method: GET
        description: Loads the Team Summary for the specified month.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startDate
          in: query
          type: string
          required: true
        - name: endDate
          in: query
          type: string
          required: true
        - name: pageSize
          in: query
          type: integer
          description: This value determines how many results will be returned per call.
        - name: pageToken
          in: query
          type: string
          description: Token corresponding to the last page of team summaries retrieved. Pass the pageToken to get the next
            page of team summaries
    - name: reports-users
      path: /reports/users
      operations:
      - name: usersummary
        method: GET
        description: Loads the User Summary for the specified time period.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
          description: team identifier associated with the requester's team
          required: true
        - name: start
          in: query
          type: string
          required: true
        - name: end
          in: query
          type: string
          required: true
        - name: period
          in: query
          type: string
          required: true
  exposes:
  - type: rest
    namespace: gremlin-reports-rest
    port: 8080
    description: REST adapter for Gremlin API — reports. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/reports/attacks
      name: reports-attacks
      description: REST surface for reports-attacks.
      operations:
      - method: GET
        name: attacksummary
        description: Loads the Attacks Summary for the specified time period.
        call: gremlin-reports.attacksummary
        with:
          teamId: rest.teamId
          start: rest.start
          end: rest.end
          period: rest.period
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/clients
      name: reports-clients
      description: REST surface for reports-clients.
      operations:
      - method: GET
        name: clientsummary
        description: Loads the Client Summary for the specified time period.
        call: gremlin-reports.clientsummary
        with:
          teamId: rest.teamId
          start: rest.start
          end: rest.end
          period: rest.period
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/companies
      name: reports-companies
      description: REST surface for reports-companies.
      operations:
      - method: GET
        name: companysummary
        description: Loads the Company Summary for the specified month.
        call: gremlin-reports.companysummary
        with:
          startDate: rest.startDate
          endDate: rest.endDate
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/companies/pdf
      name: reports-companies-pdf
      description: REST surface for reports-companies-pdf.
      operations:
      - method: GET
        name: companysummarypdf
        description: Loads the Company Summary PDF for the specified time frame.
        call: gremlin-reports.companysummarypdf
        with:
          startDate: rest.startDate
          endDate: rest.endDate
          numberOfDataPoints: rest.numberOfDataPoints
          topN: rest.topN
          filter: rest.filter
          groupBy: rest.groupBy
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/companies/reliability-management
      name: reports-companies-reliability-management
      description: REST surface for reports-companies-reliability-management.
      operations:
      - method: GET
        name: getcompanyreliabilitymanagementreport
        description: Loads the Company Reliability Management Report for the specified time window defaulting to a week.
        call: gremlin-reports.getcompanyreliabilitymanagementreport
        with:
          startDate: rest.startDate
          endDate: rest.endDate
          topN: rest.topN
          includeDailyReport: rest.includeDailyReport
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/companies/reliability-management/grouped
      name: reports-companies-reliability-management-grouped
      description: REST surface for reports-companies-reliability-management-grouped.
      operations:
      - method: GET
        name: getcompanyreliabilitymanagementreportgrouped
        description: Loads the Company Reliability Management Report grouped by query param value of groupBy - defaults to
          TEAM.
        call: gremlin-reports.getcompanyreliabilitymanagementreportgrouped
        with:
          groupBy: rest.groupBy
          numberOfDataPoints: rest.numberOfDataPoints
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/companies/reliability-management/services
      name: reports-companies-reliability-management-services
      description: REST surface for reports-companies-reliability-management-services.
      operations:
      - method: GET
        name: getcompanyreliabilitymanagementreport1
        description: Loads the company service list and reliability trend for each service for the specified time window defaulting
          to a month.
        call: gremlin-reports.getcompanyreliabilitymanagementreport1
        with:
          startDate: rest.startDate
          endDate: rest.endDate
          numberOfDataPoints: rest.numberOfDataPoints
          topN: rest.topN
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/companies/trends
      name: reports-companies-trends
      description: REST surface for reports-companies-trends.
      operations:
      - method: GET
        name: getcompanyscorerisktrends
        description: Returns the Risk and Score trends for your company across all associated services
        call: gremlin-reports.getcompanyscorerisktrends
        with:
          startDate: rest.startDate
          endDate: rest.endDate
          numberOfDataPoints: rest.numberOfDataPoints
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/pricing
      name: reports-pricing
      description: REST surface for reports-pricing.
      operations:
      - method: GET
        name: pricingreport
        description: Loads the pricing usage for the specified dates and tracking period.
        call: gremlin-reports.pricingreport
        with:
          startDate: rest.startDate
          endDate: rest.endDate
          trackingPeriod: rest.trackingPeriod
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/services/reliability-management/reliability-report-trend
      name: reports-services-reliability-management-reliability-report-trend
      description: REST surface for reports-services-reliability-management-reliability-report-trend.
      operations:
      - method: GET
        name: getreliabilityreporttrendforallservicesofteam
        description: Loads the Reliability report trend for all the services of the team for the specified time period defaulting
          to 1 months and 4 data points
        call: gremlin-reports.getreliabilityreporttrendforallservicesofteam
        with:
          startDate: rest.startDate
          endDate: rest.endDate
          numberOfDataPoints: rest.numberOfDataPoints
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/services/{serviceid}/reliability-management/reliability-report-trend
      name: reports-services-serviceid-reliability-management-reliability-report-trend
      description: REST surface for reports-services-serviceId-reliability-management-reliability-report-trend.
      operations:
      - method: GET
        name: getreliabilityreporttrendforservice
        description: Loads the Reliability report trend for the service for the specified time period defaulting to 1 months
          and 4 data points
        call: gremlin-reports.getreliabilityreporttrendforservice
        with:
          serviceId: rest.serviceId
          startDate: rest.startDate
          endDate: rest.endDate
          numberOfDataPoints: rest.numberOfDataPoints
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/team/detected-risk/trend
      name: reports-team-detected-risk-trend
      description: REST surface for reports-team-detected-risk-trend.
      operations:
      - method: GET
        name: getdetectedrisksreporttrendforteam
        description: Returns the trend of risks across all services for a given team
        call: gremlin-reports.getdetectedrisksreporttrendforteam
        with:
          teamId: rest.teamId
          startDate: rest.startDate
          endDate: rest.endDate
          numberOfDataPoints: rest.numberOfDataPoints
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/team/detected-risks-report
      name: reports-team-detected-risks-report
      description: REST surface for reports-team-detected-risks-report.
      operations:
      - method: GET
        name: getriskevaluationreportforteam
        description: Loads latest risk evaluation for each eligible service for the team
        call: gremlin-reports.getriskevaluationreportforteam
        with:
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/team/detected-risks-report/pdf
      name: reports-team-detected-risks-report-pdf
      description: REST surface for reports-team-detected-risks-report-pdf.
      operations:
      - method: GET
        name: getriskevaluationreportforteampdf
        description: Loads the team risk report PDF for the specified time frame.
        call: gremlin-reports.getriskevaluationreportforteampdf
        with:
          teamId: rest.teamId
          startDate: rest.startDate
          endDate: rest.endDate
          numberOfDataPoints: rest.numberOfDataPoints
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/team/reliability-report
      name: reports-team-reliability-report
      description: REST surface for reports-team-reliability-report.
      operations:
      - method: GET
        name: getreliabilityreportforteam
        description: Requires the privilege [`RELIABILITY_REPORTS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)
        call: gremlin-reports.getreliabilityreportforteam
        with:
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/team/reliability-report/pdf
      name: reports-team-reliability-report-pdf
      description: REST surface for reports-team-reliability-report-pdf.
      operations:
      - method: GET
        name: getreliabilityreportforteampdf
        description: Loads the team reliability report PDF for the specified time frame.
        call: gremlin-reports.getreliabilityreportforteampdf
        with:
          teamId: rest.teamId
          startDate: rest.startDate
          endDate: rest.endDate
          numberOfDataPoints: rest.numberOfDataPoints
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/team/reliability-report/trend
      name: reports-team-reliability-report-trend
      description: REST surface for reports-team-reliability-report-trend.
      operations:
      - method: GET
        name: getreliabilityreporttrendforteam
        description: Returns the trend of Reliability Scores across all services for a given team
        call: gremlin-reports.getreliabilityreporttrendforteam
        with:
          teamId: rest.teamId
          startDate: rest.startDate
          endDate: rest.endDate
          numberOfDataPoints: rest.numberOfDataPoints
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/team/trends
      name: reports-team-trends
      description: REST surface for reports-team-trends.
      operations:
      - method: GET
        name: getscorerisktrendsforteam
        description: Returns the trend of Reliability Scores across all services for a given team
        call: gremlin-reports.getscorerisktrendsforteam
        with:
          teamId: rest.teamId
          startDate: rest.startDate
          endDate: rest.endDate
          numberOfDataPoints: rest.numberOfDataPoints
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/teams
      name: reports-teams
      description: REST surface for reports-teams.
      operations:
      - method: GET
        name: teamsummaries
        description: This functionality has moved to GET /reports/teams/paged.Loads the Team Summary for the specified month.
        call: gremlin-reports.teamsummaries
        with:
          startDate: rest.startDate
          endDate: rest.endDate
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/teams/paged
      name: reports-teams-paged
      description: REST surface for reports-teams-paged.
      operations:
      - method: GET
        name: teamsummariespaged
        description: Loads the Team Summary for the specified month.
        call: gremlin-reports.teamsummariespaged
        with:
          startDate: rest.startDate
          endDate: rest.endDate
          pageSize: rest.pageSize
          pageToken: rest.pageToken
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports/users
      name: reports-users
      description: REST surface for reports-users.
      operations:
      - method: GET
        name: usersummary
        description: Loads the User Summary for the specified time period.
        call: gremlin-reports.usersummary
        with:
          teamId: rest.teamId
          start: rest.start
          end: rest.end
          period: rest.period
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: gremlin-reports-mcp
    port: 9090
    transport: http
    description: MCP adapter for Gremlin API — reports. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: loads-attacks-summary-specified-time
      description: Loads the Attacks Summary for the specified time period.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reports.attacksummary
      with:
        teamId: tools.teamId
        start: tools.start
        end: tools.end
        period: tools.period
      outputParameters:
      - type: object
        mapping: $.
    - name: loads-client-summary-specified-time
      description: Loads the Client Summary for the specified time period.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reports.clientsummary
      with:
        teamId: tools.teamId
        start: tools.start
        end: tools.end
        period: tools.period
      outputParameters:
      - type: object
        mapping: $.
    - name: loads-company-summary-specified-month
      description: Loads the Company Summary for the specified month.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reports.companysummary
      with:
        startDate: tools.startDate
        endDate: tools.endDate
      outputParameters:
      - type: object
        mapping: $.
    - name: loads-company-summary-pdf-specified
      description: Loads the Company Summary PDF for the specified time frame.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reports.companysummarypdf
      with:
        startDate: tools.startDate
        endDate: tools.endDate
        numberOfDataPoints: tools.numberOfDataPoints
        topN: tools.topN
        filter: tools.filter
        groupBy: tools.groupBy
      outputParameters:
      - type: object
        mapping: $.
    - name: loads-company-reliability-management-report
      description: Loads the Company Reliability Management Report for the specified time window defaulting to a week.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reports.getcompanyreliabilitymanagementreport
      with:
        startDate: tools.startDate
        endDate: tools.endDate
        topN: tools.topN
        includeDailyReport: tools.includeDailyReport
      outputParameters:
      - type: object
        mapping: $.
    - name: loads-company-reliability-management-report-2
      description: Loads the Company Reliability Management Report grouped by query param value of groupBy - defaults to TEAM.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reports.getcompanyreliabilitymanagementreportgrouped
      with:
        groupBy: tools.groupBy
        numberOfDataPoints: tools.numberOfDataPoints
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: loads-company-service-list-and
      description: Loads the company service list and reliability trend for each service for the specified time window defaulting
        to a month.
      hints:
 

# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gremlin/refs/heads/main/capabilities/gremlin-reports.yaml