{"openapi":"3.1.0","info":{"title":"CarbonFoot API","version":"0.1.0","description":"A fully local personal carbon-footprint calculator using documented, published EPA and academic emission factors across transportation, home energy, and diet, with a category-by-category breakdown and general reduction suggestions. Estimates from general published averages, not a certified carbon audit.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://carbonfoot.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/carbonfoot/docs"},"termsOfService":"https://connectorbay.com/carbonfoot/terms"},"servers":[{"url":"https://carbonfoot.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/carbonfoot/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/carbon_footprint_calculator":{"post":{"operationId":"carbon_footprint_calculator","summary":"Computes an estimated annual CO2e footprint from transportation (gasoline/hybrid/electric car miles,","description":"Computes an estimated annual CO2e footprint from transportation (gasoline/hybrid/electric car miles,\n    short-/long-haul flight miles), home energy (electricity, natural gas), and diet type, using documented\n    published EPA and academic emission factors. Returns total kg/tonnes CO2e, a category-by-category\n    breakdown with percentage shares, and general reduction suggestions. Use for \"what's my carbon footprint\n    if I drive 12,000 miles a year in a gas car and eat meat most days\". General published averages, not a\n    personalized or precise measurement.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gasoline_car_miles":{"default":0.0,"description":"Annual miles driven in a gasoline (non-hybrid) car.","minimum":0,"title":"Gasoline Car Miles","type":"number"},"hybrid_car_miles":{"default":0.0,"description":"Annual miles driven in a hybrid car.","minimum":0,"title":"Hybrid Car Miles","type":"number"},"electric_car_miles":{"default":0.0,"description":"Annual miles driven in a battery-electric car.","minimum":0,"title":"Electric Car Miles","type":"number"},"ev_efficiency_kwh_per_100mi":{"default":30.0,"description":"Electric car efficiency, kWh per 100 miles. Default 30 (a commonly-cited average new-EV figure).","exclusiveMinimum":0,"maximum":200,"title":"Ev Efficiency Kwh Per 100Mi","type":"number"},"short_haul_flight_miles":{"default":0.0,"description":"Annual passenger-miles flown on short-haul/domestic flights (roughly under 300 miles).","minimum":0,"title":"Short Haul Flight Miles","type":"number"},"long_haul_flight_miles":{"default":0.0,"description":"Annual passenger-miles flown on long-haul flights (roughly over 2,300 miles).","minimum":0,"title":"Long Haul Flight Miles","type":"number"},"electricity_kwh":{"default":0.0,"description":"Annual home electricity use, in kWh.","minimum":0,"title":"Electricity Kwh","type":"number"},"natural_gas_therms":{"default":0.0,"description":"Annual home natural-gas use, in therms.","minimum":0,"title":"Natural Gas Therms","type":"number"},"diet_type":{"default":"average","description":"high_meat, medium_meat (or 'average'), low_meat, fish, vegetarian, or vegan.","title":"Diet Type","type":"string"}},"title":"carbon_footprint_calculatorArguments","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/emission_factors_reference":{"post":{"operationId":"emission_factors_reference","summary":"Returns the full sourced table of published emission factors this connector uses (EPA typical-vehicle","description":"Returns the full sourced table of published emission factors this connector uses (EPA typical-vehicle\n    and eGRID grid-intensity figures, an EPA natural-gas combustion factor, and a published UK dietary-\n    footprint study's per-category figures) — with citations for each. Use for \"what emission factors are you\n    using\", \"where do these numbers come from\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"transportation, home_energy, diet, or context. Omit for the full table.","title":"Category"}},"title":"emission_factors_referenceArguments","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}}}}