{"openapi":"3.1.0","info":{"title":"Prioritygrid API","version":"0.1.0","description":"Eisenhower matrix quadrant classification, weighted priority scoring/ranking, the GTD clarify decision tree, and hand-curated GTD methodology reference.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://prioritygrid.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/prioritygrid/docs"},"termsOfService":"https://connectorbay.com/prioritygrid/terms"},"servers":[{"url":"https://prioritygrid.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/prioritygrid/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/classify_task":{"post":{"operationId":"classify_task","summary":"Classify a task into an Eisenhower-matrix quadrant (Do First / Schedule / Delegate / Delete) from urgency","description":"Classify a task into an Eisenhower-matrix quadrant (Do First / Schedule / Delegate / Delete) from urgency\n    and importance ratings, with the recommended action. Use for \"is this task urgent or important\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"urgency":{"description":"1 (not urgent) to 10 (extremely urgent).","maximum":10,"minimum":1,"title":"Urgency","type":"number"},"importance":{"description":"1 (not important) to 10 (extremely important).","maximum":10,"minimum":1,"title":"Importance","type":"number"},"task_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional label for the task.","title":"Task Name"}},"required":["urgency","importance"],"title":"classify_taskArguments","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/classify_tasks":{"post":{"operationId":"classify_tasks","summary":"Classify a batch of tasks, grouped by Eisenhower quadrant with counts. Use for \"classify these 5 tasks\".","description":"Classify a batch of tasks, grouped by Eisenhower quadrant with counts. Use for \"classify these 5 tasks\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tasks":{"description":"List of {name, urgency, importance}.","items":{"additionalProperties":true,"type":"object"},"minItems":1,"title":"Tasks","type":"array"}},"required":["tasks"],"title":"classify_tasksArguments","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/quadrant_info":{"post":{"operationId":"quadrant_info","summary":"Explain one Eisenhower-matrix quadrant: its condition, recommended action, and reasoning. Use for \"what","description":"Explain one Eisenhower-matrix quadrant: its condition, recommended action, and reasoning. Use for \"what\n    does the delegate quadrant mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"quadrant":{"description":"q1/q2/q3/q4 or do_first/schedule/delegate/delete.","title":"Quadrant","type":"string"}},"required":["quadrant"],"title":"quadrant_infoArguments","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/gtd_explainer":{"post":{"operationId":"gtd_explainer","summary":"Explain the GTD (Getting Things Done) methodology's five stages, or one of them. Use for \"what is GTD\",","description":"Explain the GTD (Getting Things Done) methodology's five stages, or one of them. Use for \"what is GTD\",\n    \"explain the clarify stage of GTD\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"stage":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"capture | clarify | organize | reflect | engage; omit for all five.","title":"Stage"}},"title":"gtd_explainerArguments","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/gtd_clarify_step":{"post":{"operationId":"gtd_clarify_step","summary":"Run the GTD clarify decision tree on one item: not actionable -> trash/someday-maybe/reference; under 2","description":"Run the GTD clarify decision tree on one item: not actionable -> trash/someday-maybe/reference; under 2\n    minutes -> do it now; multi-step -> it's a project; otherwise -> a single next action. Use for \"what's the GTD\n    clarify step for an unclear inbox item\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"task_description":{"description":"The unclear item to run through the clarify decision tree.","minLength":1,"title":"Task Description","type":"string"},"actionable":{"description":"Does this actually require action?","title":"Actionable","type":"boolean"},"multi_step":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Does it need more than one action step?","title":"Multi Step"},"estimated_minutes":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"How long the very next action would take.","title":"Estimated Minutes"}},"required":["task_description","actionable"],"title":"gtd_clarify_stepArguments","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/two_minute_rule_check":{"post":{"operationId":"two_minute_rule_check","summary":"Check GTD's two-minute rule: if it takes 2 minutes or less, do it now instead of tracking it. Use for","description":"Check GTD's two-minute rule: if it takes 2 minutes or less, do it now instead of tracking it. Use for\n    \"should I just do this now or track it\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"estimated_minutes":{"description":"How long the task would take.","minimum":0,"title":"Estimated Minutes","type":"integer"}},"required":["estimated_minutes"],"title":"two_minute_rule_checkArguments","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/priority_score":{"post":{"operationId":"priority_score","summary":"Compute a weighted priority score from urgency, importance and optional effort. Use for \"score this task's","description":"Compute a weighted priority score from urgency, importance and optional effort. Use for \"score this task's\n    priority\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"urgency":{"maximum":10,"minimum":1,"title":"Urgency","type":"number"},"importance":{"maximum":10,"minimum":1,"title":"Importance","type":"number"},"effort":{"anyOf":[{"maximum":10,"minimum":1,"type":"number"},{"type":"null"}],"default":null,"description":"1 (trivial) to 10 (huge); higher effort lowers the score.","title":"Effort"},"weights":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"default":null,"description":"Override any of urgency/importance/effort weights (defaults 1.0/1.5/0.5).","title":"Weights"}},"required":["urgency","importance"],"title":"priority_scoreArguments","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/rank_tasks":{"post":{"operationId":"rank_tasks","summary":"Compute a priority score for each task and rank them highest to lowest. Use for \"rank these tasks by","description":"Compute a priority score for each task and rank them highest to lowest. Use for \"rank these tasks by\n    priority\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tasks":{"description":"List of {name, urgency, importance, effort?}.","items":{"additionalProperties":true,"type":"object"},"minItems":1,"title":"Tasks","type":"array"},"weights":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"default":null,"description":"Override scoring weights.","title":"Weights"}},"required":["tasks"],"title":"rank_tasksArguments","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/weekly_review_checklist":{"post":{"operationId":"weekly_review_checklist","summary":"The classic GTD weekly review checklist. Use for \"what should my weekly review cover\".","description":"The classic GTD weekly review checklist. Use for \"what should my weekly review cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"weekly_review_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}},"/v1/tools/delegation_candidate_check":{"post":{"operationId":"delegation_candidate_check","summary":"Recommend whether to delegate a task based on its Eisenhower quadrant and how well someone else could do","description":"Recommend whether to delegate a task based on its Eisenhower quadrant and how well someone else could do\n    it. Use for \"should I delegate this task\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"urgency":{"maximum":10,"minimum":1,"title":"Urgency","type":"number"},"importance":{"maximum":10,"minimum":1,"title":"Importance","type":"number"},"skill_match":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"only_me | someone_else_equally_good | someone_else_better | unknown","title":"Skill Match"},"task_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Task Name"}},"required":["urgency","importance"],"title":"delegation_candidate_checkArguments","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}}}}