{"openapi":"3.1.0","info":{"title":"Yojana API","version":"0.1.0","description":"A directory of major Indian central government welfare schemes: search, detail, category browsing, an eligibility checker, document checklists, a glossary, ration-card categories, and PM-KISAN/PMJJBY/PMSBY calculators.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://yojana.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/yojana/docs"},"termsOfService":"https://connectorbay.com/yojana/terms"},"servers":[{"url":"https://yojana.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/yojana/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/scheme_search":{"post":{"operationId":"scheme_search","summary":"Search schemes by keyword across name, objective, benefits, category and ministry. Use for \"housing schemes\",","description":"Search schemes by keyword across name, objective, benefits, category and ministry. Use for \"housing schemes\",\n    \"farmer support schemes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword: name, benefit, or topic.","examples":["housing","insurance","farmer income"],"minLength":2,"title":"Query","type":"string"},"limit":{"default":10,"maximum":30,"minimum":1,"title":"Limit","type":"integer"}},"required":["query"],"title":"scheme_searchArguments","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/scheme_info":{"post":{"operationId":"scheme_info","summary":"Full detail for one scheme: objective, benefits, eligibility rules, how to apply, documents required, helpline","description":"Full detail for one scheme: objective, benefits, eligibility rules, how to apply, documents required, helpline\n    and official portal. Use for \"what's Ayushman Bharat\", \"how do I apply for PMAY\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"scheme":{"description":"Scheme name or id.","examples":["PM-KISAN","Ayushman Bharat","pmay-urban"],"title":"Scheme","type":"string"}},"required":["scheme"],"title":"scheme_infoArguments","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/schemes_by_category":{"post":{"operationId":"schemes_by_category","summary":"List all schemes in a category. Use for \"pension schemes\", \"insurance schemes\".","description":"List all schemes in a category. Use for \"pension schemes\", \"insurance schemes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"agriculture | health | housing | energy | financial-inclusion | pension | insurance | business | skill-development | women | food-security | employment","title":"Category","type":"string"}},"required":["category"],"title":"schemes_by_categoryArguments","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/eligibility_checker":{"post":{"operationId":"eligibility_checker","summary":"A rule-based eligibility scan across all schemes: lists schemes whose stated eligibility rules are not","description":"A rule-based eligibility scan across all schemes: lists schemes whose stated eligibility rules are not\n    contradicted by the details you give. Any detail you leave out is treated as unknown, not disqualifying, so\n    results are a starting shortlist, not a guarantee — always confirm on the scheme's own portal. Use for \"am I\n    eligible for any schemes\" — give whatever details you know.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"age":{"anyOf":[{"maximum":120,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Age"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"male | female","title":"Gender"},"rural":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True if rural, False if urban.","title":"Rural"},"occupation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"e.g. farmer, street_vendor, self_employed, artisan.","title":"Occupation"},"is_bpl":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Whether the household is BPL/below-poverty-line.","title":"Is Bpl"},"owns_pucca_house":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Whether the household already owns a pucca (permanent) house.","title":"Owns Pucca House"},"caste_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"general | sc | st | obc, if relevant to the scheme.","title":"Caste Category"}},"title":"eligibility_checkerArguments","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/document_checklist":{"post":{"operationId":"document_checklist","summary":"The documents typically required to apply for one scheme. Use for \"what documents do I need for PM-KISAN\".","description":"The documents typically required to apply for one scheme. Use for \"what documents do I need for PM-KISAN\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"scheme":{"description":"Scheme name or id.","title":"Scheme","type":"string"}},"required":["scheme"],"title":"document_checklistArguments","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/scheme_glossary":{"post":{"operationId":"scheme_glossary","summary":"Definitions of common terms used across government schemes (BPL, SECC, DBT, EWS/LIG/MIG, etc). Use for \"what","description":"Definitions of common terms used across government schemes (BPL, SECC, DBT, EWS/LIG/MIG, etc). Use for \"what\n    does BPL mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"scheme_glossaryArguments","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/ration_card_categories":{"post":{"operationId":"ration_card_categories","summary":"The four ration-card categories (AAY, PHH, BPL, APL): who typically qualifies and the typical monthly","description":"The four ration-card categories (AAY, PHH, BPL, APL): who typically qualifies and the typical monthly\n    entitlement. Use for \"what's the difference between AAY and BPL ration cards\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"ration_card_categoriesArguments","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/pm_kisan_calculator":{"post":{"operationId":"pm_kisan_calculator","summary":"Total PM-KISAN income support received given a number of installments (₹2,000 each, 3 per year, ₹6,000/year).","description":"Total PM-KISAN income support received given a number of installments (₹2,000 each, 3 per year, ₹6,000/year).\n    Use for \"PM-KISAN total after 9 installments\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"installments_received":{"description":"Number of ₹2,000 installments received so far.","maximum":100,"minimum":0,"title":"Installments Received","type":"integer"}},"required":["installments_received"],"title":"pm_kisan_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/insurance_schemes_calculator":{"post":{"operationId":"insurance_schemes_calculator","summary":"Eligibility, premium and cover for PMJJBY (life insurance) and PMSBY (accident insurance) at a given age. Use","description":"Eligibility, premium and cover for PMJJBY (life insurance) and PMSBY (accident insurance) at a given age. Use\n    for \"can a 52-year-old join PMJJBY or PMSBY\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"age":{"maximum":120,"minimum":0,"title":"Age","type":"integer"}},"required":["age"],"title":"insurance_schemes_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/list_schemes":{"post":{"operationId":"list_schemes","summary":"The full directory: every scheme covered, with its ministry, category and one-line objective. Use for \"what","description":"The full directory: every scheme covered, with its ministry, category and one-line objective. Use for \"what\n    schemes do you know about\", to browse before narrowing with scheme_search or schemes_by_category.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_schemesArguments","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}}}}