{"openapi":"3.1.0","info":{"title":"FranchiseBasics API","version":"0.1.0","description":"US franchise-ownership basics reference: real terminology, the real FTC Franchise Rule FDD item contents, and a genuine pre-purchase due-diligence checklist. Hand-curated; not legal, financial, or investment advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://franchisebasics.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/franchisebasics/docs"},"termsOfService":"https://connectorbay.com/franchisebasics/terms"},"servers":[{"url":"https://franchisebasics.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/franchisebasics/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/franchise_glossary":{"post":{"operationId":"franchise_glossary","summary":"Definitions of real franchise-ownership terms (franchise fee, royalty percentage, FDD, territory rights,","description":"Definitions of real franchise-ownership terms (franchise fee, royalty percentage, FDD, territory rights,\n    encroachment, term/renewal, area developer, master franchise, working capital, non-compete, transfer fee,\n    FDD Item 3/19/20 concepts, ...). Use for \"what's a royalty in franchising\", \"what does FDD stand for\".","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":"franchise_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/fdd_contents_guide":{"post":{"operationId":"fdd_contents_guide","summary":"What the FTC Franchise Rule (16 CFR Part 436) actually requires each numbered item of a Franchise","description":"What the FTC Franchise Rule (16 CFR Part 436) actually requires each numbered item of a Franchise\n    Disclosure Document (FDD) to contain — all 23 items, or one specific item. Use for \"what has to be in FDD\n    Item 19\", \"what does the litigation item in an FDD cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"item_number":{"anyOf":[{"maximum":23,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"A specific FDD item number, 1-23; omit to list all 23.","title":"Item Number"}},"title":"fdd_contents_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/pre_purchase_checklist":{"post":{"operationId":"pre_purchase_checklist","summary":"Genuine due-diligence questions to work through before buying any franchise, organized by area (unit","description":"Genuine due-diligence questions to work through before buying any franchise, organized by area (unit\n    economics, franchisee turnover/litigation history, territory/encroachment, fees/royalty structure,\n    term/renewal/exit, support obligations, professional review) and keyed to the FDD item that answers each.\n    Use for \"what should I ask before buying a franchise\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"pre_purchase_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}}}}