{"openapi":"3.1.0","info":{"title":"Quiver API","version":"0.1.0","description":"A recreational/target archery reference and calculator: bow types, a draw-length estimator, draw-weight starting guidance, arrow spine concepts, scoring systems, competition formats, range safety fundamentals, and an equipment glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://quiver.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/quiver/docs"},"termsOfService":"https://connectorbay.com/quiver/terms"},"servers":[{"url":"https://quiver.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/quiver/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/bow_type_info":{"post":{"operationId":"bow_type_info","summary":"Characteristics and typical use of a bow type — recurve, compound, longbow, or traditional (barebow-style).","description":"Characteristics and typical use of a bow type — recurve, compound, longbow, or traditional (barebow-style).\n    Use for \"what's the difference between a recurve and a compound bow\", \"what is a longbow\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A bow type.","examples":["recurve","compound","longbow","traditional"],"title":"Name","type":"string"}},"required":["name"],"title":"bow_type_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/draw_length_estimate":{"post":{"operationId":"draw_length_estimate","summary":"Estimate a starting draw length from wingspan (the standard wingspan / 2.5 formula) and/or height, with a","description":"Estimate a starting draw length from wingspan (the standard wingspan / 2.5 formula) and/or height, with a\n    note that a professional shop fitting is more accurate. Use for \"estimate my draw length\", \"what draw length\n    do I need if my wingspan is 68 inches\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"height_inches":{"anyOf":[{"maximum":96,"minimum":24,"type":"number"},{"type":"null"}],"default":null,"description":"Height in inches.","title":"Height Inches"},"wingspan_inches":{"anyOf":[{"maximum":96,"minimum":24,"type":"number"},{"type":"null"}],"default":null,"description":"Arm span / wingspan in inches, fingertip to fingertip.","title":"Wingspan Inches"}},"title":"draw_length_estimateArguments","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/draw_weight_guide":{"post":{"operationId":"draw_weight_guide","summary":"General starting draw-weight ranges (in pounds) by experience level or age band, plus notes on build,","description":"General starting draw-weight ranges (in pounds) by experience level or age band, plus notes on build,\n    compound-vs-recurve perceived effort, and bowhunting minimums. Use for \"what draw weight should a beginner\n    start with\", \"draw weight for a 12-year-old\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"experience_level":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"e.g. first_time, youth, beginner, intermediate, experienced; omit to list all levels.","title":"Experience Level"}},"title":"draw_weight_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/arrow_spine_guide":{"post":{"operationId":"arrow_spine_guide","summary":"Explains the arrow-spine concept (shaft stiffness/flex) and the general factors that affect selection —","description":"Explains the arrow-spine concept (shaft stiffness/flex) and the general factors that affect selection —\n    draw weight, arrow length, point weight, bow type — conceptually, without a precise chart (exact selection\n    needs a manufacturer's spine chart for a specific setup). Use for \"what is arrow spine\", \"what affects which\n    arrow spine I need\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"arrow_spine_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/scoring_system_info":{"post":{"operationId":"scoring_system_info","summary":"How scoring works in target archery (10-ring), field archery (field/hunter/animal/WA field rounds), or 3D","description":"How scoring works in target archery (10-ring), field archery (field/hunter/animal/WA field rounds), or 3D\n    archery. Use for \"how does archery scoring work\", \"what's the difference between field and target scoring\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"discipline":{"description":"target archery | field archery | 3d archery","title":"Discipline","type":"string"}},"required":["discipline"],"title":"scoring_system_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/competition_format_info":{"post":{"operationId":"competition_format_info","summary":"The Olympic recurve competition format (ranking round, set-system matches, team and mixed-team) and/or the","description":"The Olympic recurve competition format (ranking round, set-system matches, team and mixed-team) and/or the\n    compound format (cumulative 15-arrow matches; not currently an Olympic event). Use for \"how does Olympic\n    archery scoring work\", \"what's the compound archery match format\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"olympic recurve | compound; omit for both.","title":"Format Name"}},"title":"competition_format_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/range_safety_guide":{"post":{"operationId":"range_safety_guide","summary":"Core archery range-safety fundamentals — never point a bow at anything you don't intend to shoot, range","description":"Core archery range-safety fundamentals — never point a bow at anything you don't intend to shoot, range\n    commands, safe arrow retrieval, and more — drawn from widely-taught safety principles (not one specific\n    range's own posted rules). Use for \"archery safety rules\", \"how do I retrieve arrows safely\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"range_safety_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/equipment_glossary":{"post":{"operationId":"equipment_glossary","summary":"Definitions of common archery equipment terms (nock, fletching, riser, cam, let-off, anchor point, and","description":"Definitions of common archery equipment terms (nock, fletching, riser, cam, let-off, anchor point, and\n    more). Use for \"what does let-off mean\", \"what's a clicker in archery\".","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":"equipment_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/search":{"post":{"operationId":"search","summary":"Search bow types, glossary terms, scoring systems, competition formats, arrow spine, range safety, and","description":"Search bow types, glossary terms, scoring systems, competition formats, arrow spine, range safety, and\n    draw-weight/draw-length guidance for a keyword. Use for \"find everything about let-off\", \"search for field\n    archery\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A keyword to search for across all reference entries.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"searchArguments","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}}}}