{
  "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
  "name": "uk.co.ampmap/chargers",
  "version": "1.0.0",
  "title": "Amp Map",
  "description": "UK EV chargers: search, live socket status, nearby and cheapest charging.",
  "websiteUrl": "https://ampmap.co.uk/developers",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://ampmap.co.uk/mcp",
      "supportedProtocolVersions": [
        "2025-11-25",
        "2025-06-18",
        "2025-03-26",
        "2024-11-05"
      ],
      "headers": [
        {
          "name": "Authorization",
          "description": "Bearer access token from Amp Map's OAuth sign-in. Only the tools that act for a driver need it; reading needs none.",
          "isRequired": false,
          "isSecret": true
        }
      ]
    }
  ],
  "serverInfo": {
    "name": "ampmap",
    "title": "Amp Map",
    "version": "1.0.0"
  },
  "protocolVersion": "2025-11-25",
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://ampmap.co.uk/mcp"
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  },
  "authentication": {
    "required": false,
    "schemes": [
      "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.",
    "protectedResourceMetadata": "https://ampmap.co.uk/.well-known/oauth-protected-resource/mcp",
    "authorizationServerMetadata": "https://ampmap.co.uk/.well-known/oauth-authorization-server",
    "scopes": [
      "charger:checkin",
      "charger:report",
      "charger:review",
      "charger:photo",
      "charger:watch"
    ]
  },
  "instructions": "Read-only UK EV charger data from Amp Map. Use search_places to turn a town, postcode or network into coordinates, then find_chargers_near or find_cheapest_charging; get_charger_status gives one charger's live sockets and prices. Live status and prices come from charge point operators' feeds and Open Charge Map; prices can change, so tell drivers to check before charging. Credit the operators and Open Charge Map, and link to the charger page given in each result. With the driver's permission you can also act for them: checkin_charger, report_charger_problem, rate_charger and upload_charger_photo need an OAuth access token from Amp Map's sign-in (the protected resource metadata names the authorisation server). What you file counts as the driver's own contribution; ratings and photos appear once Amp Map has checked them.",
  "documentationUrl": "https://ampmap.co.uk/developers#agents",
  "tools": [
    {
      "name": "search_places",
      "title": "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.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 2,
            "maxLength": 80,
            "description": "What to search for: a place, postcode, charger name or street, or network name. 2 to 80 characters."
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Search places, chargers and networks",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "find_chargers_near",
      "title": "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.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number",
            "minimum": 49,
            "maximum": 61,
            "description": "Latitude in decimal degrees (WGS 84), within the UK."
          },
          "longitude": {
            "type": "number",
            "minimum": -9,
            "maximum": 2.5,
            "description": "Longitude in decimal degrees (WGS 84), within the UK."
          },
          "radiusMiles": {
            "type": "number",
            "minimum": 0.5,
            "maximum": 50,
            "default": 10,
            "description": "Only chargers within this many miles. 0.5 to 50, default 10."
          },
          "minPowerKw": {
            "type": "number",
            "minimum": 0,
            "maximum": 400,
            "description": "Only sites with at least this power, in kW (for example 50 for rapid, 150 for ultra-rapid)."
          },
          "connector": {
            "type": "string",
            "enum": [
              "type2",
              "ccs",
              "chademo",
              "type1",
              "3pin"
            ],
            "description": "Only sites with this connector."
          },
          "network": {
            "type": "string",
            "minLength": 2,
            "maxLength": 60,
            "description": "Only this charging network: its slug or name, as returned by search_places (for example \"tesla\" or \"bp-pulse\")."
          },
          "availableNow": {
            "type": "boolean",
            "description": "Only sites whose live status shows a socket free now."
          },
          "openNow": {
            "type": "boolean",
            "description": "Leave out sites whose published opening hours say they are closed now."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "default": 10,
            "description": "How many chargers, 1 to 20 (default 10)."
          }
        },
        "required": [
          "latitude",
          "longitude"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Find chargers near a point",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_charger_status",
      "title": "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.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z0-9-]{1,120}$",
            "description": "Charger id, as returned by the other tools or in an ampmap.co.uk/charger/{id} URL."
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Live status of one charger",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "find_cheapest_charging",
      "title": "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.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number",
            "minimum": 49,
            "maximum": 61,
            "description": "Latitude in decimal degrees (WGS 84), within the UK. Use with longitude, instead of place."
          },
          "longitude": {
            "type": "number",
            "minimum": -9,
            "maximum": 2.5,
            "description": "Longitude in decimal degrees (WGS 84), within the UK. Use with latitude, instead of place."
          },
          "place": {
            "type": "string",
            "minLength": 2,
            "maxLength": 80,
            "description": "A UK town, city or postcode, instead of latitude and longitude. 2 to 80 characters."
          },
          "radiusMiles": {
            "type": "number",
            "minimum": 1,
            "maximum": 25,
            "description": "Search radius in miles, 1 to 25. Default 5 around a point; around a place, enough to cover it."
          },
          "minPowerKw": {
            "type": "number",
            "minimum": 0,
            "maximum": 400,
            "description": "Only prices for connectors of at least this power, in kW."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "default": 10,
            "description": "How many chargers, 1 to 20 (default 10)."
          }
        },
        "additionalProperties": false
      },
      "annotations": {
        "title": "Cheapest charging nearby",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "checkin_charger",
      "title": "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).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "charger_id": {
            "type": "string",
            "pattern": "^[a-z0-9-]{1,120}$",
            "description": "Charger id, as returned by the read tools or in an ampmap.co.uk/charger/{id} URL."
          },
          "worked": {
            "type": "boolean",
            "description": "true if the charge worked; false if it did not (filed as a fault report)."
          },
          "note": {
            "type": "string",
            "maxLength": 300,
            "description": "Optional short note in the driver's words, up to 300 characters."
          }
        },
        "required": [
          "charger_id",
          "worked"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Check in at a charger",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "report_charger_problem",
      "title": "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).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "charger_id": {
            "type": "string",
            "pattern": "^[a-z0-9-]{1,120}$",
            "description": "Charger id, as returned by the read tools or in an ampmap.co.uk/charger/{id} URL."
          },
          "kind": {
            "type": "string",
            "enum": [
              "blocked",
              "fault",
              "incorrect-info",
              "other"
            ],
            "description": "fault, blocked, incorrect-info or other."
          },
          "socket_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Optional: the socket the problem is with, as the label get_charger_status gives (for fault and blocked only)."
          },
          "note": {
            "type": "string",
            "maxLength": 500,
            "description": "Optional details in the driver's words, up to 500 characters."
          }
        },
        "required": [
          "charger_id",
          "kind"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Report a problem with a charger",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "rate_charger",
      "title": "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).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "charger_id": {
            "type": "string",
            "pattern": "^[a-z0-9-]{1,120}$",
            "description": "Charger id, as returned by the read tools or in an ampmap.co.uk/charger/{id} URL."
          },
          "stars": {
            "type": "integer",
            "minimum": 1,
            "maximum": 5,
            "description": "Whole stars, 1 (poor) to 5 (excellent)."
          },
          "review": {
            "type": "string",
            "maxLength": 500,
            "description": "Optional review in the driver's words, up to 500 characters."
          }
        },
        "required": [
          "charger_id",
          "stars"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Rate and review a charger",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "upload_charger_photo",
      "title": "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).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "charger_id": {
            "type": "string",
            "pattern": "^[a-z0-9-]{1,120}$",
            "description": "Charger id, as returned by the read tools or in an ampmap.co.uk/charger/{id} URL."
          },
          "image": {
            "type": "string",
            "minLength": 16,
            "maxLength": 8392704,
            "description": "The photo as base64 (JPEG, PNG or WebP), optionally as a data: URL."
          },
          "caption": {
            "type": "string",
            "maxLength": 200,
            "description": "Optional caption for the reviewer, up to 200 characters. Not published."
          }
        },
        "required": [
          "charger_id",
          "image"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Add a photo of a charger",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": false
      }
    }
  ]
}