{"openapi":"3.1.0","info":{"title":"Khaleej (Gulf) API","version":"0.1.0","description":"A fully local GCC/Gulf-region civic and general reference: per-country facts (capital, currency, calling code, official language, national day) for the six GCC states, the GCC institution itself, regional business-week and holiday norms, currency and dialing conventions, and a Khaleeji-identity glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://khaleej.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/khaleej/docs"},"termsOfService":"https://connectorbay.com/khaleej/terms"},"servers":[{"url":"https://khaleej.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/khaleej/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/country_info":{"post":{"operationId":"country_info","summary":"One GCC country's capital, currency (name, ISO code, USD-peg status), calling code, official language,","description":"One GCC country's capital, currency (name, ISO code, USD-peg status), calling code, official language,\n    and national day. Use for \"what's the capital of Qatar\", \"what currency does Oman use\", \"calling code for\n    Kuwait\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A GCC country's name, official name, or capital.","examples":["Qatar","UAE","Saudi Arabia","Muscat"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"country_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/country_search":{"post":{"operationId":"country_search","summary":"Search every GCC country's name, capital, currency, calling code and official language for a keyword.","description":"Search every GCC country's name, capital, currency, calling code and official language for a keyword.\n    Use for \"which GCC country uses the dinar\", \"which country has calling code +968\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A keyword: part of a name, capital, currency, calling code or language.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"country_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/gcc_overview_info":{"post":{"operationId":"gcc_overview_info","summary":"The Gulf Cooperation Council itself: founding date and place (1981, Abu Dhabi), all six member states,","description":"The Gulf Cooperation Council itself: founding date and place (1981, Abu Dhabi), all six member states,\n    its stated purpose, key milestones (customs union, common market), and the stalled 'Khaleeji' common-\n    currency proposal. Use for \"when was the GCC founded\", \"what is the GCC for\", \"is there a Gulf currency\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"gcc_overview_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/compare_countries":{"post":{"operationId":"compare_countries","summary":"A side-by-side comparison table (capital, currency, calling code, official language, national day,","description":"A side-by-side comparison table (capital, currency, calling code, official language, national day,\n    weekend days) across all six GCC states, or a chosen subset. Use for \"compare Saudi Arabia and Qatar\",\n    \"table of GCC countries\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"GCC country names to compare; omit for all six.","examples":[["Saudi Arabia","UAE"]],"title":"Countries"}},"title":"compare_countriesArguments","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/business_week_info":{"post":{"operationId":"business_week_info","summary":"Each GCC country's current weekend days and how long that's been the arrangement -- most of the region","description":"Each GCC country's current weekend days and how long that's been the arrangement -- most of the region\n    uses Friday-Saturday, but the UAE alone moved to Saturday-Sunday (with a Friday half day) from 1 January\n    2022. Use for \"is the weekend Friday-Saturday in Dubai\", \"what's the work week in Saudi Arabia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A GCC country name; omit for all six.","title":"Country"}},"title":"business_week_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/currency_reference":{"post":{"operationId":"currency_reference","summary":"Each GCC currency's name, ISO code, and long-standing peg arrangement (five of six pegged to the US","description":"Each GCC currency's name, ISO code, and long-standing peg arrangement (five of six pegged to the US\n    dollar; the Kuwaiti dinar floats against an undisclosed basket since 2007) -- a factual structural note,\n    never a live or current exchange rate. Use for \"is the Saudi riyal pegged to the dollar\", \"what currency\n    does Bahrain use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A GCC country name; omit for all six.","title":"Country"}},"title":"currency_referenceArguments","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/national_day_info":{"post":{"operationId":"national_day_info","summary":"Each GCC country's national-day date and a brief note on its historical significance. Use for \"when is","description":"Each GCC country's national-day date and a brief note on its historical significance. Use for \"when is\n    UAE National Day\", \"what does Qatar National Day commemorate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A GCC country name; omit for all six.","title":"Country"}},"title":"national_day_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/dialing_and_format_reference":{"post":{"operationId":"dialing_and_format_reference","summary":"Each GCC country's international calling code and general phone-number format conventions (typical","description":"Each GCC country's international calling code and general phone-number format conventions (typical\n    length, mobile-prefix pattern). Use for \"calling code for Bahrain\", \"how many digits in a Qatari mobile\n    number\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A GCC country name; omit for all six.","title":"Country"}},"title":"dialing_and_format_referenceArguments","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/khaleej_glossary":{"post":{"operationId":"khaleej_glossary","summary":"A ten-term glossary of GCC-specific vocabulary and the Khaleeji ('of the Gulf') identity concept,","description":"A ten-term glossary of GCC-specific vocabulary and the Khaleeji ('of the Gulf') identity concept,\n    covered factually. Use for \"what does khaleeji mean\", \"what is a majlis\", \"what is a wali in Oman\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"khaleeji | gcc | majlis | diwan | wali | souq | dhow | expatriate_majority | amir | hijri_calendar; omit to list all ten terms.","title":"Term"}},"title":"khaleej_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}}}}