{"openapi":"3.1.0","info":{"title":"Bahr (Pearl & Sea) API","version":"0.1.0","description":"A fully local Gulf pearl-diving heritage and maritime-culture reference: the historical pearl-diving industry, traditional diving technique and tools, dhow types, pearl grading, the industry's decline, traditional navigation, and cultural legacy.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://bahr.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/bahr/docs"},"termsOfService":"https://connectorbay.com/bahr/terms"},"servers":[{"url":"https://bahr.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/bahr/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/pearl_diving_history_info":{"post":{"operationId":"pearl_diving_history_info","summary":"A historical overview of the Gulf natural pearl-diving industry and its economic centrality to the","description":"A historical overview of the Gulf natural pearl-diving industry and its economic centrality to the\n    pre-oil coastal economy — its scale (boats and workers by port), crew structure (nakhoda, tawash,\n    ghawwas, seib, nahham), the seasonal al-ghous al-kabeer diving season, and the advance-and-debt system\n    that financed it. Use for \"how important was pearl diving to the Gulf economy\", \"who worked on a\n    pearling boat\", \"what was the pearling season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"pearl_diving_history_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/diving_technique_info":{"post":{"operationId":"diving_technique_info","summary":"Traditional Gulf free-diving method and tools for pearl diving — the fitam nose clip, khabt finger","description":"Traditional Gulf free-diving method and tools for pearl diving — the fitam nose clip, khabt finger\n    guards, diving weight/stone, collection basket (deyeen) and rope (yada), how a dive was carried out, and\n    the physical risks divers faced. Use for \"how did pearl divers hold their breath\", \"what is a fitam\",\n    \"what tools did pearl divers use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"diving_technique_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/dhow_type_info":{"post":{"operationId":"dhow_type_info","summary":"One traditional Gulf dhow type's size, hull features, traditional use and region — covers the","description":"One traditional Gulf dhow type's size, hull features, traditional use and region — covers the\n    sambuk, boom, shu'ai, jalibut, baghlah and ghanjah. Use for \"what is a sambuk\", \"tell me about the boom\n    dhow\", \"what was a baghlah used for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A traditional dhow type's name or alias.","examples":["sambuk","boom","shu'ai","baghlah","ghanjah","jalibut"],"title":"Name","type":"string"}},"required":["name"],"title":"dhow_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/dhow_search":{"post":{"operationId":"dhow_search","summary":"Search traditional Gulf dhow types by partial name, alias, region, size or traditional use. Use for","description":"Search traditional Gulf dhow types by partial name, alias, region, size or traditional use. Use for\n    \"which dhow was used for pearling\", \"dhows built in Kuwait\", \"large deep-sea dhow types\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial dhow name, alias, region, size, or a word from its traditional use or description.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"dhow_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/pearl_grading_info":{"post":{"operationId":"pearl_grading_info","summary":"How natural pearls were traditionally sorted and graded in the Gulf pearl trade — sieve-based sizing","description":"How natural pearls were traditionally sorted and graded in the Gulf pearl trade — sieve-based sizing\n    (makhall), traditional weight units (habba, miskal/mithqal, chow), shape and origin terms (dana, qomash,\n    yatima), and the pearl merchant's (tawash) role. Describes historical grading methods only — never\n    states or estimates a current pearl market price. Use for \"how were pearls graded before modern\n    grading\", \"what is a habba\", \"what does dana mean for pearls\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"pearl_grading_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/industry_decline_info":{"post":{"operationId":"industry_decline_info","summary":"The historical factors behind the Gulf natural pearl industry's decline — the rise of Japanese","description":"The historical factors behind the Gulf natural pearl industry's decline — the rise of Japanese\n    cultured pearls from 1916, the Great Depression's collapse of luxury demand, and the growth of the oil\n    economy — with a build-out timeline and the industry's population impact on pearling towns. Use for\n    \"why did the Gulf pearl industry decline\", \"when did cultured pearls take over\", \"how did oil affect\n    pearl diving\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"industry_decline_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/maritime_navigation_info":{"post":{"operationId":"maritime_navigation_info","summary":"Traditional Gulf and Indian Ocean seafaring navigation — the kamal star-altitude instrument,","description":"Traditional Gulf and Indian Ocean seafaring navigation — the kamal star-altitude instrument,\n    monsoon-timed voyaging, dead reckoning and coastal piloting, and the navigator Ahmad ibn Majid and his\n    Kitab al-Fawa'id. Use for \"how did dhow captains navigate without a compass\", \"what is a kamal\", \"who\n    was Ahmad ibn Majid\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"maritime_navigation_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/cultural_legacy_info":{"post":{"operationId":"cultural_legacy_info","summary":"How Gulf pearl-diving heritage is remembered and preserved today — Bahrain's UNESCO-listed Pearling","description":"How Gulf pearl-diving heritage is remembered and preserved today — Bahrain's UNESCO-listed Pearling\n    Path, and general categories such as maritime museums, heritage festivals, oral history from former\n    divers, dhow-building and racing culture, and pearling-era work songs. Describes general categories, not\n    a directory of specific current attractions or operating details. Use for \"how is pearl-diving heritage\n    remembered today\", \"is there a UNESCO site for Gulf pearling\", \"how is pearling history preserved\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"cultural_legacy_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/maritime_glossary":{"post":{"operationId":"maritime_glossary","summary":"Definitions of Gulf pearl-diving and maritime heritage terms (bahr, nakhoda, tawash, ghawwas, seib,","description":"Definitions of Gulf pearl-diving and maritime heritage terms (bahr, nakhoda, tawash, ghawwas, seib,\n    nahham, ghous al-kabeer, fitam, sanbuk, dana, tawash grading, kamal). Use for \"what does nakhoda mean\",\n    \"what is a tawash\", \"what does fitam 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":"maritime_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}}}}