generated: '2026-07-27'
method: derived
source:
  - mcp/chargy-mcp.yml
  - openapi/chargy-open-charge-point-data-openapi.yml
description: >-
  Binding between the candidate MCP tool surface and the real OpenAPI operations
  of the char.gy open data feed. Because the MCP surface is derived rather than
  published, every binding is exact by construction — each tool IS one
  operation, and inherits that operation's parameters as its input schema. There
  are no MCP-only and no REST-only capabilities on the open surface.
surfaces:
  openapi:
    file: openapi/chargy-open-charge-point-data-openapi.yml
    operations: 2
    gated: false
    note: Generated by API Evangelist from live probes; char.gy publishes no spec.
  graphql:
    endpoint: null
    note: https://char.gy/graphql returns 404 — no GraphQL surface exists.
  mcp:
    url: null
    gated: false
    note: >-
      No MCP server exists; tools are candidates derived from the OpenAPI.
      tools/list could not be called because there is nothing to call.
  ocpi_cpo:
    endpoint: https://char.gy/ocpi/cpo
    gated: true
    note: >-
      OCPI 2.2.1 / 2.1.1 CPO roaming interface, credential-gated behind
      Authorization Token realm="OCPI". Its module surface (sessions, cdrs,
      tokens, commands, credentials) is real but undocumented and unmapped —
      no operation there can be bound without a partner credential.
crosswalk:
  - tool: list_charge_point_locations
    category: reference-data
    rest: [listLocations]
    binding: rest
    confidence: high
    note: >-
      One-to-one. Input schema is the operation's limit, offset, date_from and
      date_to parameters.
  - tool: list_charging_tariffs
    category: pricing
    rest: [listTariffs]
    binding: rest
    confidence: high
    note: One-to-one. Same four paging/filter parameters.
mcp_only: []
rest_only: []
gated_unmapped:
  - surface: ocpi_cpo
    reason: >-
      Partner-only OCPI CPO modules. Their existence is proven (401 with
      www-authenticate on /ocpi/cpo/2.2.1/{locations,tariffs,sessions,cdrs,
      credentials}) but no schema is obtainable anonymously, so nothing is
      mapped rather than guessed.
coverage:
  tools_named: 2
  tools_bound: 2
  mcp_only: 0
  rest_operations_total: 2
  rest_operations_with_tool: 2