{"openapi":"3.0.3","info":{"title":"Grant Readiness Checklist API","version":"2.0.0","description":"Public decision-support API for The Grant Readiness Checklist. It supports one decision: helping a nonprofit understand how prepared it is to pursue grant funding and which readiness gaps to close before applying. Given answers across seven grant-readiness areas, it returns a weighted 0-100 readiness score, a readiness tier, a category breakdown, detected risk flags, a prioritized action plan and grant-packet guidance. This is the same canonical decision engine used by the human web interface, the browser WebMCP tool and the Remote MCP server. Limitations: Grant readiness does not guarantee grant eligibility, approval, or funding. This tool does not replace a funder's requirements or final eligibility determination. This tool does not provide legal, tax, accounting, or financial advice.","contact":{"name":"The Document Pro","url":"https://thedocumentpro.com/","email":"mydocumentpro@gmail.com"}},"servers":[{"url":"https://grantreadinesschecklist.com","description":"Production"}],"paths":{"/api/v1/assess-grant-readiness":{"post":{"operationId":"assessGrantReadiness","summary":"Assess a nonprofit’s grant readiness","description":"Runs the canonical grant-readiness decision engine on the supplied answers and returns a structured readiness assessment. No authentication required.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssessmentInput"},"examples":{"nested":{"summary":"Answers nested by readiness area","value":{"tax_registrations":{"tax_exempt_status_letter":"Have it","ein_number":"12-3456789","irs_form_990":"Filed on time"},"financials":{"org_budget_current":"Have it","financial_statement_recent":"Have it"},"governance":{"articles_of_incorporation":"Have it","bylaws":"Have it","board_size":"7"}}},"flat":{"summary":"Flat field_id map","value":{"tax_exempt_status_letter":"Have it","irs_form_990":"Filed on time","org_budget_current":"Have it","board_size":"7"}}}}}},"responses":{"200":{"description":"Structured grant-readiness assessment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssessmentResponse"}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Assessment could not be computed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"operationId":"describeAssessGrantReadiness","summary":"Describe the assessment endpoint","responses":{"200":{"description":"Endpoint description."}}}},"/api/mcp":{"get":{"operationId":"getMcpManifest","summary":"Remote MCP server manifest","description":"Returns the MCP server manifest (protocol 2025-06-18) describing the assess_grant_readiness tool.","responses":{"200":{"description":"MCP manifest."}}},"post":{"operationId":"callMcp","summary":"MCP JSON-RPC endpoint","description":"JSON-RPC 2.0: initialize, tools/list, tools/call. tools/call executes the canonical decision engine.","responses":{"200":{"description":"JSON-RPC result."}}}}},"components":{"schemas":{"AssessmentInput":{"type":"object","description":"Grant-readiness answers. Provide either a flat map of field_id -> value or an object nested by readiness area (org_background, tax_registrations, financials, governance, program_project, policies, supporting_docs). Unknown fields are ignored.","additionalProperties":true},"AssessmentResponse":{"type":"object","properties":{"success":{"type":"boolean","example":true},"tool":{"type":"string","example":"assess_grant_readiness"},"score":{"type":"integer","minimum":0,"maximum":100,"example":62},"category":{"type":"string","enum":["Not Ready","Early Stage","Getting There","Mostly Ready","Grant Ready"],"example":"Getting There"},"key_findings":{"type":"array","items":{"type":"string"}},"next_steps":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}},"version":{"type":"string","example":"2.0.0"},"result":{"type":"object","description":"Full structured result: score, category, categoryBreakdown, riskFlags, actionPlan, keyFindings, nextSteps, grantPacketGuidance, limitations, version."}},"required":["success","tool","score","category","version"]},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean","example":false},"tool":{"type":"string"},"error":{"type":"string"},"version":{"type":"string"}},"required":["success","error"]}}}}