naftiko: 1.0.0-alpha2
info:
  label: Fastly Observability — Timeseries
  description: Query time-series metrics across services, domains, and origins via the Fastly Observability Timeseries endpoint.
  tags: [Fastly, Observability, Metrics]
  created: '2026-05-22'
  modified: '2026-05-22'
binds:
- namespace: env
  keys: { FASTLY_API_KEY: FASTLY_API_KEY }
capability:
  consumes:
  - type: http
    namespace: observability-timeseries
    baseUri: https://api.fastly.com
    description: Fastly Timeseries metrics queries.
    resources:
    - name: timeseries
      path: /observability/timeseries
      operations:
      - { name: querytimeseries, method: GET, description: Query timeseries, outputRawFormat: json, outputParameters: [ { name: result, type: object, value: $. } ] }
    - name: insights
      path: /observability/insights
      operations:
      - { name: listinsights, method: GET, description: List insights, outputRawFormat: json, outputParameters: [ { name: result, type: object, value: $. } ] }
    authentication: { type: apikey, key: Fastly-Key, value: '{{env.FASTLY_API_KEY}}', placement: header }
  exposes:
  - type: rest
    namespace: observability-timeseries-rest
    port: 8080
    description: REST adapter.
    resources:
    - path: /v1/observability/timeseries
      name: timeseries
      description: Timeseries query.
      operations:
      - { method: GET, name: querytimeseries, description: Query timeseries, call: observability-timeseries.querytimeseries, outputParameters: [ { type: object, mapping: $. } ] }
    - path: /v1/observability/insights
      name: insights
      description: Insights list.
      operations:
      - { method: GET, name: listinsights, description: List insights, call: observability-timeseries.listinsights, outputParameters: [ { type: object, mapping: $. } ] }
  - type: mcp
    namespace: observability-timeseries-mcp
    port: 9090
    transport: http
    description: MCP adapter.
    tools:
    - { name: query-timeseries, description: Query Fastly observability timeseries, hints: { readOnly: true, destructive: false, idempotent: true }, call: observability-timeseries.querytimeseries, outputParameters: [ { type: object, mapping: $. } ] }
    - { name: list-insights, description: List Fastly observability insights, hints: { readOnly: true, destructive: false, idempotent: true }, call: observability-timeseries.listinsights, outputParameters: [ { type: object, mapping: $. } ] }