{"openapi":"3.1.0","info":{"title":"Free Business Forms API","version":"1.0.0-preview","description":"Public evaluation API for discovering, validating, and rendering versioned operational business forms. Do not send highly sensitive data.","contact":{"url":"https://freebusinessforms.com/contact"}},"servers":[{"url":"https://freebusinessforms.com","description":"Production"}],"tags":[{"name":"Forms"},{"name":"Validation"},{"name":"Rendering"}],"paths":{"/api/v1/forms":{"get":{"tags":["Forms"],"operationId":"searchForms","summary":"List or search registered forms","parameters":[{"in":"query","name":"q","schema":{"type":"string"}}],"responses":{"200":{"description":"Form registry"}}}},"/schemas/{slug}":{"get":{"tags":["Forms"],"operationId":"getJsonSchema","summary":"Get raw JSON Schema for one form","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON Schema document"},"404":{"description":"Unknown form"}}}},"/api/v1/forms/{slug}":{"get":{"tags":["Forms"],"operationId":"getFormSchema","summary":"Get form metadata and JSON Schema","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Form record"},"404":{"description":"Unknown form"}}}},"/api/v1/validate":{"post":{"tags":["Validation"],"operationId":"validateFormData","summary":"Validate data against a form","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["slug","data"],"properties":{"slug":{"type":"string","example":"invoice"},"data":{"type":"object","additionalProperties":true},"line_items":{"type":"array","items":{"type":"object"}}}}}}},"responses":{"200":{"description":"Validation result"},"404":{"description":"Unknown form"}}}},"/api/v1/render":{"post":{"tags":["Rendering"],"operationId":"renderForm","summary":"Render validated data as JSON, plain text, HTML, PDF, or Word","parameters":[{"in":"query","name":"format","schema":{"type":"string","enum":["json","text","html","pdf","docx"],"default":"json"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["slug","data"],"properties":{"slug":{"type":"string","example":"invoice"},"data":{"type":"object","additionalProperties":true},"line_items":{"type":"array","items":{"type":"object"}}}}}}},"responses":{"200":{"description":"Rendered form"},"404":{"description":"Unknown form"},"422":{"description":"Validation failed"}}}},"/mcp":{"get":{"tags":["Integration"],"operationId":"getMcpCapabilities","summary":"Discover MCP endpoints and available tools","responses":{"200":{"description":"MCP tool metadata"}}},"post":{"tags":["Integration"],"operationId":"mcpRpc","summary":"Call MCP JSON-RPC tools directly.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"]}}}},"responses":{"200":{"description":"Tool result payload"},"400":{"description":"Bad JSON-RPC request"},"404":{"description":"Unknown method"}}}}}}