{"openapi":"3.1.0","info":{"title":"EssayOutline API","version":"0.1.0","description":"An essay-structure outline generator by type, a deterministic thesis-strength heuristic checker, a transition-word reference, and a paragraph-structure reference (PEEL, CEA).\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://essayoutline.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/essayoutline/docs"},"termsOfService":"https://connectorbay.com/essayoutline/terms"},"servers":[{"url":"https://essayoutline.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/essayoutline/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/outline_generator":{"post":{"operationId":"outline_generator","summary":"A real, type-appropriate structured essay outline with each section's purpose explained. Use for","description":"A real, type-appropriate structured essay outline with each section's purpose explained. Use for\n    \"give me an outline for an argumentative essay about remote work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"essay_type":{"description":"argumentative | narrative | expository | compare_contrast | cause_effect","title":"Essay Type","type":"string"},"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional essay topic to attach to the outline.","title":"Topic"}},"required":["essay_type"],"title":"outline_generatorArguments","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/thesis_strength_checker":{"post":{"operationId":"thesis_strength_checker","summary":"Six deterministic heuristic checks on a thesis (not a question, not an announcement, clear position,","description":"Six deterministic heuristic checks on a thesis (not a question, not an announcement, clear position,\n    no hedging, no vague words, reasonable length) with an overall weak/moderate/strong verdict and the\n    specific issues found. Use for \"is this a strong thesis: ...\"\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"thesis":{"description":"A thesis statement to evaluate.","minLength":1,"title":"Thesis","type":"string"}},"required":["thesis"],"title":"thesis_strength_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/transition_word_reference":{"post":{"operationId":"transition_word_reference","summary":"Real transition words/phrases grouped by function. Use for \"give me contrast transition words\",","description":"Real transition words/phrases grouped by function. Use for \"give me contrast transition words\",\n    \"what are some cause-and-effect transitions\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"function":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"addition | contrast | cause_effect | sequence_time | emphasis | example | comparison | conclusion_summary. Omit to list all.","title":"Function"}},"title":"transition_word_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/paragraph_structure_reference":{"post":{"operationId":"paragraph_structure_reference","summary":"PEEL (Point, Evidence, Explain, Link) or CEA (Claim, Evidence, Analysis) — widely taught","description":"PEEL (Point, Evidence, Explain, Link) or CEA (Claim, Evidence, Analysis) — widely taught\n    body-paragraph frameworks. Use for \"what's the PEEL paragraph structure\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"method":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"peel | cea. Omit to list both.","title":"Method"}},"title":"paragraph_structure_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}}}}