{"openapi":"3.1.0","info":{"title":"Collect API Gas Prices (BYOK) API","version":"0.1.0","description":"Collect API Gas Prices (BYOK) lets an AI assistant read your own Collect API Gas Prices data through the Collect API Gas Prices API with a key you supply (CollectAPI key (sent as 'apikey <key>')). Read-only: 12 tools (get_usa_state_averages, get_usa_state_prices, list_usa_state_codes, list_usa_cities, get_canada_prices, get_european_prices, get_australia_prices, get_poland_prices,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-collectapi-gasprice.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-collectapi-gasprice/docs"},"termsOfService":"https://connectorbay.com/byok-collectapi-gasprice/terms"},"servers":[{"url":"https://byok-collectapi-gasprice.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-collectapi-gasprice/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/get_usa_state_averages":{"post":{"operationId":"get_usa_state_averages","summary":"List average gasoline, mid-grade, premium and diesel prices for every US state (US dollars per gallon, as text). Use for","description":"List average gasoline, mid-grade, premium and diesel prices for every US state (US dollars per gallon, as text). Use for \"What are the average gas prices in every US state\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_usa_state_averagesArguments","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_usa_state_prices":{"post":{"operationId":"get_usa_state_prices","summary":"Get gas prices for one US state plus its cities, from the state's two-letter code. Use for \"What are gas prices in Washi","description":"Get gas prices for one US state plus its cities, from the state's two-letter code. Use for \"What are gas prices in Washington state and its cities\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"state":{"description":"Two-letter US state code, for example 'WA' (see the state code tool).","maxLength":2,"title":"State","type":"string"}},"required":["state"],"title":"get_usa_state_pricesArguments","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_usa_state_codes":{"post":{"operationId":"list_usa_state_codes","summary":"List US state names with their two-letter codes, for use with the state price tool. Use for \"What is the code for Alaska","description":"List US state names with their two-letter codes, for use with the state price tool. Use for \"What is the code for Alaska in the gas price service\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_usa_state_codesArguments","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_usa_cities":{"post":{"operationId":"list_usa_cities","summary":"List the US cities that have fuel price data, grouped by state. Use for \"Which US cities have gas price data\".","description":"List the US cities that have fuel price data, grouped by state. Use for \"Which US cities have gas price data\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_usa_citiesArguments","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_canada_prices":{"post":{"operationId":"get_canada_prices","summary":"Get average gasoline prices in Canadian dollars for cities, grouped by province. Use for \"What do gas prices look like i","description":"Get average gasoline prices in Canadian dollars for cities, grouped by province. Use for \"What do gas prices look like in Canadian cities\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_canada_pricesArguments","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_european_prices":{"post":{"operationId":"get_european_prices","summary":"Get gasoline, diesel and LPG prices by European country (values are text with a decimal comma; a dash means no data). Us","description":"Get gasoline, diesel and LPG prices by European country (values are text with a decimal comma; a dash means no data). Use for \"How much is diesel in each European country\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_european_pricesArguments","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_australia_prices":{"post":{"operationId":"get_australia_prices","summary":"Get gasoline, diesel and LPG prices for Australian cities. Use for \"What is petrol in Sydney and Melbourne\".","description":"Get gasoline, diesel and LPG prices for Australian cities. Use for \"What is petrol in Sydney and Melbourne\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_australia_pricesArguments","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_poland_prices":{"post":{"operationId":"get_poland_prices","summary":"Get national and per-voivodeship fuel prices in Poland (gasoline 95 and 98, diesel, premium diesel, LPG; zloty, decimal ","description":"Get national and per-voivodeship fuel prices in Poland (gasoline 95 and 98, diesel, premium diesel, LPG; zloty, decimal comma). Use for \"What do fuels cost in Poland\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_poland_pricesArguments","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_world_gasoline_prices":{"post":{"operationId":"get_world_gasoline_prices","summary":"Get weekly gasoline prices per country for countries not covered by the regional tools (US dollars per litre as text). U","description":"Get weekly gasoline prices per country for countries not covered by the regional tools (US dollars per litre as text). Use for \"Which countries have the cheapest gasoline\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_world_gasoline_pricesArguments","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_world_diesel_prices":{"post":{"operationId":"get_world_diesel_prices","summary":"Get weekly diesel prices per country for countries not covered by the regional tools (US dollars per litre as text). Use","description":"Get weekly diesel prices per country for countries not covered by the regional tools (US dollars per litre as text). Use for \"Which countries have the cheapest diesel\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_world_diesel_pricesArguments","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_prices_by_coordinates":{"post":{"operationId":"get_fuel_prices_by_coordinates","summary":"Get the country-level average gasoline, diesel and LPG prices for the country containing a latitude and longitude. Use f","description":"Get the country-level average gasoline, diesel and LPG prices for the country containing a latitude and longitude. Use for \"What are fuel prices where I am at 41.015, 28.979\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"lat":{"description":"Latitude, for example 41.015137.","maximum":90,"minimum":-90,"title":"Lat","type":"number"},"lng":{"description":"Longitude, for example 28.979530.","maximum":180,"minimum":-180,"title":"Lng","type":"number"},"type":{"anyOf":[{"enum":["gasoline","diesel","lpg"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional fuel filter: gasoline, diesel or lpg.","title":"Type"}},"required":["lat","lng"],"title":"get_fuel_prices_by_coordinatesArguments","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_prices_by_city":{"post":{"operationId":"get_fuel_prices_by_city","summary":"Get the country-level average gasoline, diesel and LPG prices for the country of a named city. Use for \"What are fuel pr","description":"Get the country-level average gasoline, diesel and LPG prices for the country of a named city. Use for \"What are fuel prices in Istanbul\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"city":{"description":"City name, for example 'istanbul'.","maxLength":80,"title":"City","type":"string"},"type":{"anyOf":[{"enum":["gasoline","diesel","lpg"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional fuel filter: gasoline, diesel or lpg.","title":"Type"}},"required":["city"],"title":"get_fuel_prices_by_cityArguments","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}}}}