{"openapi":"3.1.0","info":{"title":"Kisan API","version":"0.1.0","description":"Farm weather with soil and ET0, rain history, growing degree days, crop guides, fertilizer and irrigation calculators, pest and disease guide, land units.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://kisan.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/kisan/docs"},"termsOfService":"https://connectorbay.com/kisan/terms"},"servers":[{"url":"https://kisan.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/kisan/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/farm_weather":{"post":{"operationId":"farm_weather","summary":"Field forecast: daily rain and chance, ET0, temperatures, soil temperature and moisture (0–9 cm, 9–27 cm),","description":"Field forecast: daily rain and chance, ET0, temperatures, soil temperature and moisture (0–9 cm, 9–27 cm),\n    humidity, wind, radiation, sunrise/sunset, spray-window rating and agronomic flags (frost, heat, heavy rain,\n    wind, disease pressure). Use for \"weather for my farm this week\", \"can I spray tomorrow\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Village/town with state or country.","examples":["Nashik, Maharashtra","Ludhiana, Punjab","Fresno, CA"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"},"days":{"default":7,"maximum":14,"minimum":1,"title":"Days","type":"integer"}},"title":"farm_weatherArguments","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/rain_history":{"post":{"operationId":"rain_history","summary":"Rain, temperature, humidity and ET0 for a past window (ERA5 reanalysis, up to ~5 days ago), with totals, wet","description":"Rain, temperature, humidity and ET0 for a past window (ERA5 reanalysis, up to ~5 days ago), with totals, wet\n    days, dry spells and the wettest day. Use for \"rain in August at Latur\", \"how dry was last month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Place with state or country.","title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"},"start":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD (default 30 days ago).","title":"Start"},"end":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD (default yesterday).","title":"End"}},"title":"rain_historyArguments","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/growing_degree_days":{"post":{"operationId":"growing_degree_days","summary":"Accumulated growing degree days since sowing (archive to ~5 days ago plus forecast to today), against the","description":"Accumulated growing degree days since sowing (archive to ~5 days ago plus forecast to today), against the\n    crop's base temperature and typical GDD to maturity, with a progress estimate. Use for \"how far along is my maize\n    sown 15 June at Indore\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"crop":{"description":"Crop name.","examples":["maize","cotton","wheat","tomato"],"title":"Crop","type":"string"},"sowing_date":{"description":"Sowing/transplant date YYYY-MM-DD.","title":"Sowing Date","type":"string"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Place with state or country.","title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"}},"required":["crop","sowing_date"],"title":"growing_degree_daysArguments","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/crop_guide":{"post":{"operationId":"crop_guide","summary":"Package of practices for a crop: seasons and sowing/harvest windows, duration, seed rate, spacing, water, soil,","description":"Package of practices for a crop: seasons and sowing/harvest windows, duration, seed rate, spacing, water, soil,\n    pH, NPK, growth stages, yield, main pests and diseases, FAO-56 Kc and GDD base. Or list crops by category. Use for\n    \"when to sow wheat\", \"spacing for tomato\", \"which pulses can I grow\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"crop":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Crop name or local name.","examples":["wheat","tur","bhindi","cotton"],"title":"Crop"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Or list by type: cereal, pulse, oilseed, fibre, cash, vegetable, fruit, plantation, spice, flower.","title":"Category"}},"title":"crop_guideArguments","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/fertilizer_calc":{"post":{"operationId":"fertilizer_calc","summary":"Turn a crop's NPK recommendation (or your own kg/ha) and your field area into fertilizer quantities — urea, DAP","description":"Turn a crop's NPK recommendation (or your own kg/ha) and your field area into fertilizer quantities — urea, DAP\n    or SSP, MOP, or a complex — in kg and 50 kg bags, with a basal/top-dressing split. Use for \"fertilizer for 2 acres\n    of tomato\", \"5 bigha wheat in UP\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"crop":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Crop (uses its recommended NPK).","examples":["wheat","tomato"],"title":"Crop"},"area":{"default":1,"description":"Area value.","exclusiveMinimum":0,"title":"Area","type":"number"},"unit":{"default":"acre","description":"hectare | acre | bigha (name the state) | guntha | cent | kanal | marla | sq m","examples":["acre","bigha punjab"],"title":"Unit","type":"string"},"n_kg_ha":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Override N kg/ha (e.g. from a soil test).","title":"N Kg Ha"},"p_kg_ha":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Override P2O5 kg/ha.","title":"P Kg Ha"},"k_kg_ha":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Override K2O kg/ha.","title":"K Kg Ha"},"scheme":{"default":"urea+DAP+MOP","description":"urea+DAP+MOP | urea+SSP+MOP | NPK 10:26:26+urea","title":"Scheme","type":"string"}},"title":"fertilizer_calcArguments","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/irrigation_advice":{"post":{"operationId":"irrigation_advice","summary":"Daily crop water need from ET0 × FAO-56 Kc for the growth stage, minus effective rain from the forecast, as","description":"Daily crop water need from ET0 × FAO-56 Kc for the growth stage, minus effective rain from the forecast, as\n    mm/day and litres for your area and system efficiency, with a 7-day outlook. Use for \"how much to irrigate chilli\n    at flowering on 2 acres with drip\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"crop":{"description":"Crop.","examples":["chilli","wheat","banana"],"title":"Crop","type":"string"},"stage":{"default":"mid","description":"initial/seedling | mid/flowering/vegetative | late/maturity","title":"Stage","type":"string"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Place for live ET0 and rain (or give et0_mm_day).","title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"},"et0_mm_day":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Reference ET if known.","title":"Et0 Mm Day"},"area":{"default":1,"exclusiveMinimum":0,"title":"Area","type":"number"},"unit":{"default":"acre","description":"hectare | acre | bigha (state) | guntha …","title":"Unit","type":"string"},"efficiency":{"default":0.75,"description":"System efficiency: drip 0.9, sprinkler 0.75, furrow/flood 0.6.","exclusiveMinimum":0.2,"maximum":1.0,"title":"Efficiency","type":"number"}},"required":["crop"],"title":"irrigation_adviceArguments","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/pest_guide":{"post":{"operationId":"pest_guide","summary":"Identify a pest or disease from its name or symptom, per crop: symptoms, monitoring thresholds and IPM steps","description":"Identify a pest or disease from its name or symptom, per crop: symptoms, monitoring thresholds and IPM steps\n    (cultural → biological → chemical). Use for \"chilli leaves curling upward\", \"rice dead hearts\", \"pests of cotton\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Pest/disease name or a symptom.","examples":["white powder on leaves","whitefly","dead hearts","late blight"],"title":"Query"},"crop":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Crop to filter by.","examples":["chilli","rice"],"title":"Crop"}},"title":"pest_guideArguments","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/land_units":{"post":{"operationId":"land_units","summary":"Convert a land area to hectares, acres, square metres and the common Indian units, with the state-wise bigha","description":"Convert a land area to hectares, acres, square metres and the common Indian units, with the state-wise bigha\n    table. Use for \"5 bigha in Punjab to acres\", \"how many guntha in an acre\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"value":{"exclusiveMinimum":0,"title":"Value","type":"number"},"unit":{"description":"From unit: acre, hectare, bigha (with state), guntha, cent, kanal, marla, ground, are, sq m, sq ft, sq yd","examples":["bigha punjab","guntha","acre"],"title":"Unit","type":"string"}},"required":["value","unit"],"title":"land_unitsArguments","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}}}}