{"openapi":"3.1.0","info":{"title":"HERE Fuel Prices API (your key) API","version":"0.1.0","description":"HERE Fuel Prices API (your key) lets an AI assistant read your own HERE Fuel Prices data through the HERE Fuel Prices API with a key you supply (HERE API key). Read-only: 7 tools (search_fuel_stations, get_fuel_station, get_fuel_stations_bulk, count_fuel_stations, list_fuel_types, list_fuel_brands, get_service_version). The BYOK key travels with each request, is used for that one call only and is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-here-fuel-prices.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-here-fuel-prices/docs"},"termsOfService":"https://connectorbay.com/byok-here-fuel-prices/terms"},"servers":[{"url":"https://byok-here-fuel-prices.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-here-fuel-prices/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_fuel_stations":{"post":{"operationId":"search_fuel_stations","summary":"Find fuel stations with current prices inside a circle, bounding box or corridor, sortable by price or distance; returns","description":"Find fuel stations with current prices inside a circle, bounding box or corridor, sortable by price or distance; returns station name, brand, position, address label and prices per fuel type. Use for \"What are the cheapest petrol prices within 5 km of central Berlin\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"area":{"description":"Area as 'circle:LAT,LNG;r=METERS', 'bbox:WEST,SOUTH,EAST,NORTH' or 'corridor:POLYLINE;r=METERS', for example 'circle:52.5308,13.3847;r=5000'.","maxLength":2000,"title":"Area","type":"string"},"fuel_types":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated fuel type ids (see list_fuel_types), for example '-3' for all petrol or '-2' for all diesel.","title":"Fuel Types"},"brands":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated brand names to keep (see list_fuel_brands).","title":"Brands"},"sort":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Sort as 'price:asc', 'price:desc', 'distance:asc' or 'distance:desc' (distance only for circle searches).","title":"Sort"},"return_all_stations":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to also include stations with unknown prices.","title":"Return All Stations"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Maximum stations per page (default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first result, for paging.","title":"Offset"}},"required":["area"],"title":"search_fuel_stationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_fuel_station":{"post":{"operationId":"get_fuel_station","summary":"Get one fuel station by id with brand, address, position, opening flag and current prices. Use for \"Show fuel station 27","description":"Get one fuel station by id with brand, address, position, opening flag and current prices. Use for \"Show fuel station 276u33db-8ce1fe1fd8b44f81b7a5ca5ba4f3be1e\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"station_id":{"description":"Fuel station id from search_fuel_stations.","maxLength":100,"title":"Station Id","type":"string"}},"required":["station_id"],"title":"get_fuel_stationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_fuel_stations_bulk":{"post":{"operationId":"get_fuel_stations_bulk","summary":"Get several fuel stations by id in one call; by default only dynamic data (prices), or all data with content=all. Use fo","description":"Get several fuel stations by id in one call; by default only dynamic data (prices), or all data with content=all. Use for \"Get the current prices for these two fuel stations\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ids":{"description":"Comma-separated station ids.","maxLength":2000,"title":"Ids","type":"string"},"content":{"anyOf":[{"enum":["dynamic","all"],"type":"string"},{"type":"null"}],"default":"dynamic","description":"dynamic (prices only, default) or all (static and dynamic data).","title":"Content"}},"required":["ids"],"title":"get_fuel_stations_bulkArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/count_fuel_stations":{"post":{"operationId":"count_fuel_stations","summary":"Count the fuel stations inside a circle, bounding box or corridor. Use for \"How many fuel stations are within 10 km of c","description":"Count the fuel stations inside a circle, bounding box or corridor. Use for \"How many fuel stations are within 10 km of central Berlin\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"area":{"description":"Area as 'circle:LAT,LNG;r=METERS', 'bbox:WEST,SOUTH,EAST,NORTH' or 'corridor:POLYLINE;r=METERS'.","maxLength":2000,"title":"Area","type":"string"}},"required":["area"],"title":"count_fuel_stationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_fuel_types":{"post":{"operationId":"list_fuel_types","summary":"List the fuel types and categories (all petrol, all diesel, LPG, CNG and specific grades) with ids and parent ids. Use f","description":"List the fuel types and categories (all petrol, all diesel, LPG, CNG and specific grades) with ids and parent ids. Use for \"Which fuel types can I filter by\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_fuel_typesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_fuel_brands":{"post":{"operationId":"list_fuel_brands","summary":"List the fuel station brands, optionally for one country. Use for \"Which fuel station brands exist in Germany\".","description":"List the fuel station brands, optionally for one country. Use for \"Which fuel station brands exist in Germany\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-3 country code, for example 'DEU'.","title":"Country"}},"title":"list_fuel_brandsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_service_version":{"post":{"operationId":"get_service_version","summary":"Show the Fuel Prices API version. Use for \"Which version of the HERE Fuel Prices API is running\".","description":"Show the Fuel Prices API version. Use for \"Which version of the HERE Fuel Prices API is running\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_service_versionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}