Build with Tao Climate.
Evidence-linked carbon scenarios and public project discovery for software and AI agents serving technology, AI and aviation buyers.
Start with the contract
OpenAPI specification · Public project JSON · Method and input schema
Version 1.0 supports a dry-biomass building-material scenario. It is not a general product or flight footprint engine. Inputs and references are user supplied, not independently validated.
Calculate a scenario
POST JSON to /agent/v1/calculations. Public requests are stateless, limited to the existing 24 KB body limit and 300 calculations per minute per server instance. HTTP 422 means invalid input; 429 means retry later. No calculation is saved automatically.
{
"dry_biomass_tonnes": {
"value": 100,
"source": "Illustrative dry mass, not project evidence"
},
"carbon_fraction": {
"value": 0.45,
"source": "Illustrative carbon fraction; laboratory validation required"
},
"retained_fraction": {
"value": 0.5,
"source": "Illustrative construction retention"
},
"storage_years": 50,
"storage_source": "Scenario assumption, not verified permanence",
"accounting_scope": "Illustrative stored-material scenario; lifecycle deductions not supplied"
}The response returns gross storage, net scenario only when all listed deductions are supplied, method version, input hash, missing inputs and warnings. Read the methodology and limitations.
Request future supply
POST /agent/v1/reservation-requests with an Authorization: Bearer verified Tao account ID token and a unique 16–80 character Idempotency-Key. Use only in an integration authorised by the account holder. Never share staff credentials or paste tokens into chat. This release does not issue third-party OAuth grants or autonomous purchasing credentials.
Fields: project_id (moldova-hemp), requested_tonnes, company, delivery_preference, optional notes, authority_confirmed=true and non_binding_acknowledged=true. A successful response is HTTP 202 with a request_id. Repeat the same body and key to retrieve the same result; changing the body returns 409. Requests are limited to five per account per hour and 300 globally per hour.
GET /agent/v1/reservation-requests/{request_id} with the same verified account to retrieve its status. Unauthenticated access returns 401; another account receives 404. Staff review requests in the existing enquiries inbox. A reviewed request remains non-binding.
Holds and purchases
POST /agent/v1/holds and /agent/v1/orders currently return 409 inventory_not_offered. No stock is allocated, payments collected or credits retired. Future activation requires approved supply, explicit buyer authority and transaction controls. Read the FAQs.