{"openapi":"3.1.0","info":{"title":"Tijara (Trade) API","version":"0.1.0","description":"A fully local reference on traditional Arab/Islamic-world commerce concepts and modern Gulf/MENA business culture: Islamic-finance terminology described factually and neutrally, business etiquette, the wasta concept, general free-zone/company-structure education, a trade glossary, historical trade routes, traditional units of trade, and negotiation-style norms. Not financial, legal, or religious advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://tijara.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/tijara/docs"},"termsOfService":"https://connectorbay.com/tijara/terms"},"servers":[{"url":"https://tijara.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/tijara/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/islamic_finance_concept_info":{"post":{"operationId":"islamic_finance_concept_info","summary":"Look up one Islamic-finance concept -- mudarabah, murabaha, musharakah, sukuk, riba, takaful, ijara,","description":"Look up one Islamic-finance concept -- mudarabah, murabaha, musharakah, sukuk, riba, takaful, ijara,\n    wakala, qard hasan, gharar, istisna, wadiah -- described factually and neutrally as field terminology,\n    with no ruling on what is or is not religiously permissible. Not financial or religious advice. Use for\n    \"what is mudarabah\", \"explain sukuk\", \"what does riba mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"An Islamic-finance term.","examples":["mudarabah","murabaha","sukuk","riba","takaful"],"minLength":1,"title":"Term","type":"string"}},"required":["term"],"title":"islamic_finance_concept_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/concept_search":{"post":{"operationId":"concept_search","summary":"Search Islamic-finance concepts, the trade glossary, business-etiquette topics, the wasta entry,","description":"Search Islamic-finance concepts, the trade glossary, business-etiquette topics, the wasta entry,\n    business-structure categories, historical trade routes and traditional trade units for a keyword, tagged\n    by section and the specific tool to call next. Use for \"search for interest-related terms\", \"anything\n    about caravans\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A keyword to search across every dataset in this connector.","examples":["interest","market","caravan","connections"],"minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"concept_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/business_etiquette_guide":{"post":{"operationId":"business_etiquette_guide","summary":"Gulf/MENA business-etiquette tips by topic -- greetings, meeting customs, hospitality, business cards,","description":"Gulf/MENA business-etiquette tips by topic -- greetings, meeting customs, hospitality, business cards,\n    time and scheduling, dress, gift-giving, communication style -- described factually and generally, not as\n    universal rules. Use for \"how do business meetings work in the Gulf\", \"what should I know about gift\n    giving in Gulf business\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"greetings | meetings | hospitality | business_cards | time_and_scheduling | dress | gift_giving | communication_style; omit to list all topics.","title":"Topic"}},"title":"business_etiquette_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/wasta_concept_info":{"post":{"operationId":"wasta_concept_info","summary":"A neutral definition of wasta -- the use of personal or social connections to facilitate an outcome --","description":"A neutral definition of wasta -- the use of personal or social connections to facilitate an outcome --\n    including how it functions and a note that perspectives on it vary widely and are actively debated in the\n    region, without taking a position on whether any particular use of it is good or bad. Use for \"what is\n    wasta\", \"explain the concept of wasta in Arab business culture\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"wasta_concept_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/business_structure_overview":{"post":{"operationId":"business_structure_overview","summary":"General education on common Gulf business-structure categories -- free zone company, mainland","description":"General education on common Gulf business-structure categories -- free zone company, mainland\n    LLC-equivalent, branch/representative office, sole establishment, holding company, offshore company --\n    with an explicit disclaimer to consult a local business advisor or lawyer for any specific situation. Not\n    company-registration, tax or legal advice. Use for \"what's a free zone company\", \"LLC vs free zone in the\n    UAE\", \"types of company structures in the Gulf\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"business_structure_overviewArguments","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/negotiation_norms_guide":{"post":{"operationId":"negotiation_norms_guide","summary":"Cultural notes on relationship-first versus transaction-first negotiation styles, described as a","description":"Cultural notes on relationship-first versus transaction-first negotiation styles, described as a\n    neutral spectrum most business cultures mix rather than a ranking of which is better, plus the pattern\n    commonly associated with Gulf/MENA business. Use for \"how does business negotiation work in the Gulf\",\n    \"relationship-first vs transaction-first negotiating\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"negotiation_norms_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/trade_glossary":{"post":{"operationId":"trade_glossary","summary":"A glossary of souk-economy terms (souk, khan/caravanserai, qafila, dallal, hawala, tajir, hisbah) and","description":"A glossary of souk-economy terms (souk, khan/caravanserai, qafila, dallal, hawala, tajir, hisbah) and\n    modern business terms (trade license, free zone, chamber of commerce, distributor vs. agent, letter of\n    credit, Incoterms). Use for \"what does souk mean\", \"what's a dallal\", \"what is hawala\".","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.","examples":["souk","hawala","letter of credit"],"title":"Term"}},"title":"trade_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/historical_trade_routes_info":{"post":{"operationId":"historical_trade_routes_info","summary":"A factual historical note on the region's role in historical trade: the incense route, Red Sea and","description":"A factual historical note on the region's role in historical trade: the incense route, Red Sea and\n    Gulf maritime trade, Silk Road connections, trans-Saharan trade, and pilgrimage-linked trade. Use for\n    \"what was the incense route\", \"how was Arabia connected to the Silk Road\", \"trans-Saharan trade history\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"historical_trade_routes_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_and_units_reference":{"post":{"operationId":"currency_and_units_reference","summary":"Historical and cultural notes on traditional units of weight and distance once used in regional trade","description":"Historical and cultural notes on traditional units of weight and distance once used in regional trade\n    -- dirham, dinar, mithqal, rotl, qintar, qirat (the origin of \"carat\"), farsakh. Historical/cultural only\n    -- never live exchange rates or current pricing. Use for \"what was a rotl\", \"where does the word carat\n    come from\", \"traditional Arab units of weight\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"currency_and_units_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}}}}