{"openapi":"3.1.0","info":{"title":"DebatePrep API","version":"0.1.0","description":"A debate-format and argument-structure reference: real speech-order/time-limit facts for four common debate formats, an argument outline builder, a rebuttal technique reference, and the Toulmin model.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://debateprep.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/debateprep/docs"},"termsOfService":"https://connectorbay.com/debateprep/terms"},"servers":[{"url":"https://debateprep.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/debateprep/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/debate_format_reference":{"post":{"operationId":"debate_format_reference","summary":"Real speech order and time limits for a debate format, or a list of all four. Use for \"what's the","description":"Real speech order and time limits for a debate format, or a list of all four. Use for \"what's the\n    speech order in Lincoln-Douglas debate\", \"how long is a policy debate round\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"lincoln_douglas (or 'LD') | policy (or 'CX') | public_forum (or 'PF') | parliamentary (or 'BP'). Omit to list all four.","title":"Format"}},"title":"debate_format_referenceArguments","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/argument_outline_builder":{"post":{"operationId":"argument_outline_builder","summary":"A claim/warrant/evidence/impact structural outline shell for YOUR claim, for you to fill in with real","description":"A claim/warrant/evidence/impact structural outline shell for YOUR claim, for you to fill in with real\n    research — never a generated or fabricated argument. Use for \"help me structure an argument that X\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"claim":{"description":"The claim/position you want to argue, e.g. 'Remote work should be a legal right, not just a perk.'","minLength":1,"title":"Claim","type":"string"},"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional broader topic/resolution this claim belongs to.","title":"Topic"}},"required":["claim"],"title":"argument_outline_builderArguments","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/rebuttal_technique_reference":{"post":{"operationId":"rebuttal_technique_reference","summary":"A rebuttal technique's definition, a worked example, and when to use it. Use for \"what's a 'turn' in","description":"A rebuttal technique's definition, a worked example, and when to use it. Use for \"what's a 'turn' in\n    debate\", \"explain how to outweigh an opponent's argument\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"technique":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"turn | mitigate | outweigh | no link | concede and reframe. Omit to list all.","title":"Technique"}},"title":"rebuttal_technique_referenceArguments","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/toulmin_model_reference":{"post":{"operationId":"toulmin_model_reference","summary":"The full six-part Toulmin model of argumentation (claim, grounds, warrant, backing, qualifier,","description":"The full six-part Toulmin model of argumentation (claim, grounds, warrant, backing, qualifier,\n    rebuttal) and how debate classrooms commonly simplify it. Use for \"explain the Toulmin model\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"toulmin_model_referenceArguments","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}}}}