{"openapi":"3.1.0","info":{"title":"Reel API","version":"0.1.0","description":"A recreational fishing reference: knot-tying instructions and use cases, game fish species ID/habitat/size, tackle and line-selection guidance, catch-and-release best practices, and a fishing glossary — all local.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://reel.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/reel/docs"},"termsOfService":"https://connectorbay.com/reel/terms"},"servers":[{"url":"https://reel.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/reel/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/knot_info":{"post":{"operationId":"knot_info","summary":"A fishing knot's use cases and full step-by-step tying instructions, plus its difficulty and which line","description":"A fishing knot's use cases and full step-by-step tying instructions, plus its difficulty and which line\n    types it works best with. Use for \"how do I tie a Palomar knot\", \"steps for an improved clinch knot\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A fishing knot name.","examples":["improved clinch knot","palomar","uni knot","blood knot"],"title":"Name","type":"string"}},"required":["name"],"title":"knot_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/knot_search":{"post":{"operationId":"knot_search","summary":"Search fishing knots by partial name, alias, or keyword. Use for \"do you have anything on the Albright","description":"Search fishing knots by partial name, alias, or keyword. Use for \"do you have anything on the Albright\n    knot\", \"what's a uni-to-uni knot\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"default":"","description":"Partial knot name, alias, or keyword; empty lists every knot.","title":"Query","type":"string"}},"title":"knot_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}},"/v1/tools/knots_by_use_case":{"post":{"operationId":"knots_by_use_case","summary":"Every knot in this reference for a given purpose. Use for \"what knot do I use to join two lines\", \"best","description":"Every knot in this reference for a given purpose. Use for \"what knot do I use to join two lines\", \"best\n    knot for a loop that lets a lure swing freely\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"use_case":{"description":"joining two lines | attaching hooks, lures & swivels | loop knots | attaching line to reel spool | rigging droppers & multiple hooks","title":"Use Case","type":"string"}},"required":["use_case"],"title":"knots_by_use_caseArguments","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/species_info":{"post":{"operationId":"species_info","summary":"A game fish species' identification characteristics, typical habitat, and typical size range, with a","description":"A game fish species' identification characteristics, typical habitat, and typical size range, with a\n    reminder to check local regulations rather than a stated bag or size limit. Use for \"how do I identify a\n    smallmouth bass\", \"where do redfish live\", \"how big do muskies get\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game fish species name.","examples":["largemouth bass","rainbow trout","red drum","striped bass"],"title":"Name","type":"string"}},"required":["name"],"title":"species_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/species_search":{"post":{"operationId":"species_search","summary":"Search the 25+ game fish species in this reference by partial name, alias, scientific name, or category.","description":"Search the 25+ game fish species in this reference by partial name, alias, scientific name, or category.\n    Use for \"what saltwater species do you cover\", \"is there anything on crappie\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"default":"","description":"Partial species name, alias, scientific name, or category (freshwater/saltwater/anadromous); empty lists every species.","title":"Query","type":"string"}},"title":"species_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}},"/v1/tools/tackle_guide":{"post":{"operationId":"tackle_guide","summary":"Rod types, reel types (spinning/baitcasting/fly/spincast/conventional), and line types","description":"Rod types, reel types (spinning/baitcasting/fly/spincast/conventional), and line types\n    (monofilament/fluorocarbon/braid) with general use-case guidance. Use for \"spinning vs baitcasting reel\",\n    \"when should I use braid vs fluorocarbon\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"rods | reels | line; omit for all three.","title":"Category"}},"title":"tackle_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/line_selection_guide":{"post":{"operationId":"line_selection_guide","summary":"General line-weight and line-type guidance by target species category — a starting point, not an exact","description":"General line-weight and line-type guidance by target species category — a starting point, not an exact\n    spec. Use for \"what line should I use for bass\", \"what leader for redfish\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"target_species":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A target species or species category, e.g. bass, trout, pike, redfish, tuna; omit for every category.","title":"Target Species"}},"title":"line_selection_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/catch_and_release_guide":{"post":{"operationId":"catch_and_release_guide","summary":"Catch-and-release best practices: landing without overplaying the fish, wet-hand handling and minimizing","description":"Catch-and-release best practices: landing without overplaying the fish, wet-hand handling and minimizing\n    air exposure, hook removal (including when to cut the line on a deep hook), and reviving a fish before\n    release. Use for \"how do I release a fish safely\", \"what do I do if a fish swallowed the hook\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"catch_and_release_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/fishing_glossary":{"post":{"operationId":"fishing_glossary","summary":"Definitions of common fishing terms (drag, leader, tippet, slot limit as a general concept, structure,","description":"Definitions of common fishing terms (drag, leader, tippet, slot limit as a general concept, structure,\n    spawn, backlash, hookset, trolling, chumming, barbless hook, catch and release, finesse fishing, livewell).\n    Use for \"what's a slot limit\", \"what does hookset mean\".","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":"fishing_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}}}}