{
  "name": "Amp Map",
  "description": "Finds UK electric vehicle chargers: searches places and networks, lists the nearest chargers with live availability, reports one charger's live socket status and prices, and finds the cheapest published prices nearby. Read-only, deterministic, no key needed.",
  "version": "1.0.0",
  "supportedInterfaces": [
    {
      "url": "https://ampmap.co.uk/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://ampmap.co.uk/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "0.3"
    }
  ],
  "provider": {
    "organization": "Amp Map",
    "url": "https://ampmap.co.uk/"
  },
  "documentationUrl": "https://ampmap.co.uk/developers#agents",
  "iconUrl": "https://ampmap.co.uk/icon.svg",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "search_places",
      "name": "Search places, chargers and networks",
      "description": "Search UK towns, cities, regions, postcodes, charging locations and charging networks by name. Places come back with a centre point and bounding box to pass to find_chargers_near or find_cheapest_charging.",
      "tags": [
        "search",
        "places",
        "postcodes",
        "networks",
        "uk"
      ],
      "examples": [
        "search Manchester",
        "search bp pulse"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "find_chargers_near",
      "name": "Find chargers near a point",
      "description": "The nearest UK EV charging locations to a point, nearest first, with live availability (sockets free, in use or out of service), top power, connectors, published price, distance in miles and a link to each charger's page.",
      "tags": [
        "ev",
        "chargers",
        "nearby",
        "live status",
        "uk"
      ],
      "examples": [
        "chargers near Leeds",
        "rapid chargers near M1 1AE"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "get_charger_status",
      "name": "Live status of one charger",
      "description": "One UK charging location in detail: name, address, network, each socket's live status, connectors and power, published prices (including time-of-day bands), opening hours, when the status was last checked and the charger's page URL.",
      "tags": [
        "ev",
        "charger",
        "live status",
        "prices"
      ],
      "examples": [
        "status of <charger id>"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "find_cheapest_charging",
      "name": "Cheapest charging nearby",
      "description": "The cheapest published per-kWh prices near a point or a named UK place, cheapest first, leaving out sites that are out of service. Give either latitude and longitude, or place.",
      "tags": [
        "ev",
        "charging",
        "prices",
        "cheapest",
        "uk"
      ],
      "examples": [
        "cheapest near York",
        "cheapest rapid charging near Bristol"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "checkin_charger",
      "name": "Check in at a charger",
      "description": "Record, as the driver, whether charging worked at a charger. worked: true is a check-in other drivers see as \"charging worked here\"; worked: false files a fault report instead. Counts as the driver's own contribution, under the same rules as the site's own check-in. Acts for the driver: needs their sign-in (OAuth, scope charger:checkin).",
      "tags": [
        "ev",
        "charger",
        "check-in",
        "acts for a driver"
      ],
      "examples": [
        "{\"skill\": \"checkin_charger\", \"input\": {\"charger_id\": \"<charger id>\", \"worked\": true}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ],
      "securityRequirements": [
        {
          "schemes": {
            "ampmapOAuth": {
              "list": [
                "charger:checkin"
              ]
            }
          }
        }
      ],
      "security": [
        {
          "ampmapOAuth": [
            "charger:checkin"
          ]
        }
      ]
    },
    {
      "id": "report_charger_problem",
      "name": "Report a problem with a charger",
      "description": "Report, as the driver, a problem at a charger: fault (a socket or the site is not working), blocked (a bay is blocked, for example by a car that is not charging), incorrect-info (the location, price or details are wrong) or other. A socket-level report only changes what other drivers see once others agree, as with any report on Amp Map. Acts for the driver: needs their sign-in (OAuth, scope charger:report).",
      "tags": [
        "ev",
        "charger",
        "fault",
        "report",
        "acts for a driver"
      ],
      "examples": [
        "{\"skill\": \"report_charger_problem\", \"input\": {\"charger_id\": \"<charger id>\", \"kind\": \"blocked\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ],
      "securityRequirements": [
        {
          "schemes": {
            "ampmapOAuth": {
              "list": [
                "charger:report"
              ]
            }
          }
        }
      ],
      "security": [
        {
          "ampmapOAuth": [
            "charger:report"
          ]
        }
      ]
    },
    {
      "id": "rate_charger",
      "name": "Rate and review a charger",
      "description": "Rate a charger 1 to 5 stars for the driver, with an optional short review. One rating per driver per charger - a new one replaces theirs. A rating sent by an assistant is checked by Amp Map before its stars and words appear. Acts for the driver: needs their sign-in (OAuth, scope charger:review).",
      "tags": [
        "ev",
        "charger",
        "rating",
        "review",
        "acts for a driver"
      ],
      "examples": [
        "{\"skill\": \"rate_charger\", \"input\": {\"charger_id\": \"<charger id>\", \"stars\": 4}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ],
      "securityRequirements": [
        {
          "schemes": {
            "ampmapOAuth": {
              "list": [
                "charger:review"
              ]
            }
          }
        }
      ],
      "security": [
        {
          "ampmapOAuth": [
            "charger:review"
          ]
        }
      ]
    },
    {
      "id": "upload_charger_photo",
      "name": "Add a photo of a charger",
      "description": "Add a photo of a charger for the driver - the bays, the signs, how to find it. JPEG, PNG or WebP, sent as base64 (a data: URL is fine), up to 6 MB. The photo is re-encoded with its camera data and location removed, and appears once Amp Map has checked it. Acts for the driver: needs their sign-in (OAuth, scope charger:photo).",
      "tags": [
        "ev",
        "charger",
        "photo",
        "acts for a driver"
      ],
      "examples": [
        "{\"skill\": \"upload_charger_photo\", \"input\": {\"charger_id\": \"<charger id>\", \"image\": \"<base64 JPEG>\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ],
      "securityRequirements": [
        {
          "schemes": {
            "ampmapOAuth": {
              "list": [
                "charger:photo"
              ]
            }
          }
        }
      ],
      "security": [
        {
          "ampmapOAuth": [
            "charger:photo"
          ]
        }
      ]
    }
  ],
  "securitySchemes": {
    "ampmapOAuth": {
      "type": "oauth2",
      "description": "OAuth 2.1 authorisation code with PKCE (S256) and dynamic client registration. Only the tools that act for a driver need a token: the driver signs in on Amp Map and chooses what to allow. Reading needs none.",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://ampmap.co.uk/oauth/authorize",
          "tokenUrl": "https://ampmap.co.uk/oauth/token",
          "refreshUrl": "https://ampmap.co.uk/oauth/token",
          "scopes": {
            "charger:checkin": "Check in at chargers as the driver",
            "charger:report": "Report problems with chargers as the driver",
            "charger:review": "Rate and review chargers as the driver",
            "charger:photo": "Add photos of chargers as the driver",
            "charger:watch": "Set, list and cancel alerts that a charger is free, for the driver"
          },
          "pkceRequired": true
        }
      },
      "oauth2MetadataUrl": "https://ampmap.co.uk/.well-known/oauth-authorization-server",
      "oauth2SecurityScheme": {
        "description": "OAuth 2.1 authorisation code with PKCE (S256) and dynamic client registration. Only the tools that act for a driver need a token: the driver signs in on Amp Map and chooses what to allow. Reading needs none.",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://ampmap.co.uk/oauth/authorize",
            "tokenUrl": "https://ampmap.co.uk/oauth/token",
            "refreshUrl": "https://ampmap.co.uk/oauth/token",
            "scopes": {
              "charger:checkin": "Check in at chargers as the driver",
              "charger:report": "Report problems with chargers as the driver",
              "charger:review": "Rate and review chargers as the driver",
              "charger:photo": "Add photos of chargers as the driver",
              "charger:watch": "Set, list and cancel alerts that a charger is free, for the driver"
            },
            "pkceRequired": true
          }
        },
        "oauth2MetadataUrl": "https://ampmap.co.uk/.well-known/oauth-authorization-server"
      }
    }
  },
  "protocolVersion": "0.3",
  "url": "https://ampmap.co.uk/a2a",
  "preferredTransport": "JSONRPC"
}