{"openapi":"3.1.0","info":{"title":"Agileglossary API","version":"0.1.0","description":"A fully local Agile/Scrum/Kanban terms and ceremony guide, verified against the official 2020 Scrum Guide: roles, events, artifacts and commitments, Kanban core practices, a Scrum-vs-Kanban comparison, a Sprint-length cadence calculator, and common misconceptions.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://agileglossary.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/agileglossary/docs"},"termsOfService":"https://connectorbay.com/agileglossary/terms"},"servers":[{"url":"https://agileglossary.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/agileglossary/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/term_lookup":{"post":{"operationId":"term_lookup","summary":"Defines one term from anywhere in the reference — a Scrum role, event, artifact, commitment, value,","description":"Defines one term from anywhere in the reference — a Scrum role, event, artifact, commitment, value,\n    Kanban practice, or general Agile term — with its category. Use for \"what's a Sprint Goal\", \"define\n    velocity\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"A term to define.","examples":["Sprint Goal","Scrum Master","velocity","WIP limit"],"minLength":1,"title":"Term","type":"string"}},"required":["term"],"title":"term_lookupArguments","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/search_terms":{"post":{"operationId":"search_terms","summary":"Keyword search across every term, definition, and category in the reference. Use for \"anything about","description":"Keyword search across every term, definition, and category in the reference. Use for \"anything about\n    work in progress\", \"terms related to estimation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search for.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"search_termsArguments","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/glossary_by_category":{"post":{"operationId":"glossary_by_category","summary":"Every term in one category. Use for \"list all the Scrum events\", \"what Kanban terms do you cover\".","description":"Every term in one category. Use for \"list all the Scrum events\", \"what Kanban terms do you cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"scrum_role | scrum_event | scrum_artifact | scrum_commitment | scrum_value | scrum_pillar | kanban_practice | kanban | general","title":"Category","type":"string"}},"required":["category"],"title":"glossary_by_categoryArguments","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/role_guide":{"post":{"operationId":"role_guide","summary":"A Scrum role's definition and accountabilities per the 2020 Scrum Guide. Use for \"what is the Scrum","description":"A Scrum role's definition and accountabilities per the 2020 Scrum Guide. Use for \"what is the Scrum\n    Master's job\", \"what is the Product Owner accountable for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"role":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Product Owner | Scrum Master | Developers; omit to list all three.","title":"Role"}},"title":"role_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/ceremony_guide":{"post":{"operationId":"ceremony_guide","summary":"A Scrum event's purpose, who attends, and its maximum timebox for a one-month Sprint, per the 2020 Scrum","description":"A Scrum event's purpose, who attends, and its maximum timebox for a one-month Sprint, per the 2020 Scrum\n    Guide. Use for \"how long is a Daily Scrum\", \"what happens in Sprint Review\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Sprint | Sprint Planning | Daily Scrum | Sprint Review | Sprint Retrospective; omit to list all five.","title":"Event"}},"title":"ceremony_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/artifact_guide":{"post":{"operationId":"artifact_guide","summary":"A Scrum artifact's definition and its commitment (Product Goal, Sprint Goal, or Definition of Done), per","description":"A Scrum artifact's definition and its commitment (Product Goal, Sprint Goal, or Definition of Done), per\n    the 2020 Scrum Guide. Use for \"what's the difference between the Product Backlog and Sprint Backlog\", \"what\n    is the Definition of Done\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"artifact":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Product Backlog | Sprint Backlog | Increment; omit to list all three.","title":"Artifact"}},"title":"artifact_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/scrum_vs_kanban":{"post":{"operationId":"scrum_vs_kanban","summary":"Compares Scrum and Kanban on cadence, roles, WIP limits, and how each handles new work arriving","description":"Compares Scrum and Kanban on cadence, roles, WIP limits, and how each handles new work arriving\n    mid-iteration. Use for \"what's the difference between Scrum and Kanban\", \"should we use Scrum or Kanban\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"scrum_vs_kanbanArguments","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/kanban_practices":{"post":{"operationId":"kanban_practices","summary":"The six core Kanban Method practices — visualize the workflow, limit WIP, manage flow, make policies","description":"The six core Kanban Method practices — visualize the workflow, limit WIP, manage flow, make policies\n    explicit, implement feedback loops, improve collaboratively. Use for \"what are the Kanban core practices\",\n    \"explain WIP limits\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"practice":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A practice name; omit to list all six.","title":"Practice"}},"title":"kanban_practicesArguments","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/cadence_calculator":{"post":{"operationId":"cadence_calculator","summary":"Scales the Scrum Guide's one-month-Sprint maximum timeboxes proportionally for a different Sprint length","description":"Scales the Scrum Guide's one-month-Sprint maximum timeboxes proportionally for a different Sprint length\n    — a common convention, not an official Scrum Guide formula, since the Guide only states exact maximums for a\n    one-month Sprint. The Daily Scrum always stays 15 minutes regardless of length. Use for \"how long should\n    Sprint Planning be for a two-week Sprint\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sprint_length_weeks":{"description":"Sprint length in weeks, e.g. 1, 2, 3, 4.","exclusiveMinimum":0,"maximum":8,"title":"Sprint Length Weeks","type":"number"}},"required":["sprint_length_weeks"],"title":"cadence_calculatorArguments","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/common_misconceptions":{"post":{"operationId":"common_misconceptions","summary":"Frequent mistaken beliefs about Scrum and Kanban, corrected — including outdated terminology from the","description":"Frequent mistaken beliefs about Scrum and Kanban, corrected — including outdated terminology from the\n    2017 Scrum Guide and practices commonly assumed to be official that are actually just common convention. Use\n    for \"is the Scrum Master a project manager\", \"is 'Development Team' still the right term\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"common_misconceptionsArguments","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}}}}