{"openapi":"3.1.0","info":{"title":"Cardcraft API","version":"0.1.0","description":"A fully local, web-search-verified business-card etiquette reference covering ten countries/country-groups: hand-use conventions, presentation and receiving etiquette, seniority ordering, translation/printing norms, common mistakes, a universal safe default, and explicit region-level notes on real within-region variation.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://cardcraft.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/cardcraft/docs"},"termsOfService":"https://connectorbay.com/cardcraft/terms"},"servers":[{"url":"https://cardcraft.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/cardcraft/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/etiquette_by_country":{"post":{"operationId":"etiquette_by_country","summary":"The full business-card etiquette record for one country/country-group: formality level, hand use,","description":"The full business-card etiquette record for one country/country-group: formality level, hand use,\n    presentation and receiving etiquette, what to avoid, seniority order, and translation/printing norms. Use\n    for \"how do I exchange business cards in Japan\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country or country-group name, e.g. 'Japan', 'UAE', 'France'.","minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"etiquette_by_countryArguments","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_list":{"post":{"operationId":"country_list","summary":"All countries/country-groups covered by this reference. Use for \"what countries do you cover for","description":"All countries/country-groups covered by this reference. Use for \"what countries do you cover for\n    business card etiquette\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"country_listArguments","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/hand_use_lookup":{"post":{"operationId":"hand_use_lookup","summary":"Just the hand-use convention for one country. Use for \"which hand do I use for business cards in","description":"Just the hand-use convention for one country. Use for \"which hand do I use for business cards in\n    India\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country or country-group name.","minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"hand_use_lookupArguments","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 of formality level, hand use, and seniority order for several countries. Use","description":"A side-by-side comparison of formality level, hand use, and seniority order for several countries. Use\n    for \"compare business card etiquette in Japan and the US\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"countries":{"description":"Two or more country/country-group names to compare.","items":{"type":"string"},"minItems":2,"title":"Countries","type":"array"}},"required":["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/search_by_convention":{"post":{"operationId":"search_by_convention","summary":"Finds every country/country-group whose record mentions a given convention. Use for \"which countries","description":"Finds every country/country-group whose record mentions a given convention. Use for \"which countries\n    require both hands for business cards\", \"where should I avoid the left hand\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"description":"A convention to search for, e.g. 'left hand', 'both hands', 'seniority', 'written note'.","minLength":1,"title":"Keyword","type":"string"}},"required":["keyword"],"title":"search_by_conventionArguments","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/seniority_and_order_guidance":{"post":{"operationId":"seniority_and_order_guidance","summary":"Just the seniority/ordering guidance for one country — who to exchange cards with first. Use for \"who","description":"Just the seniority/ordering guidance for one country — who to exchange cards with first. Use for \"who\n    do I give my card to first in a Korean meeting\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country or country-group name.","minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"seniority_and_order_guidanceArguments","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/translation_and_printing_tips":{"post":{"operationId":"translation_and_printing_tips","summary":"Just the translation/printing norms for one country — whether a bilingual card is expected. Use for","description":"Just the translation/printing norms for one country — whether a bilingual card is expected. Use for\n    \"do I need my business card translated for a meeting in China\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country or country-group name.","minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"translation_and_printing_tipsArguments","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/common_mistakes":{"post":{"operationId":"common_mistakes","summary":"Frequent cross-cultural business-card etiquette mistakes with fixes. Use for \"what are common business","description":"Frequent cross-cultural business-card etiquette mistakes with fixes. Use for \"what are common business\n    card etiquette mistakes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"common_mistakesArguments","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/universal_safe_default":{"post":{"operationId":"universal_safe_default","summary":"A safe default approach to use when the specific country isn't covered here or you're unsure. Use for","description":"A safe default approach to use when the specific country isn't covered here or you're unsure. Use for\n    \"what's a safe default for exchanging business cards abroad\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"universal_safe_defaultArguments","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/regional_note":{"post":{"operationId":"regional_note","summary":"An explicit, sourced note on where a broad region actually varies country-to-country in business-card","description":"An explicit, sourced note on where a broad region actually varies country-to-country in business-card\n    etiquette, so it's never mistaken for one interchangeable rule. Use for \"is business card etiquette the\n    same across the Middle East\", \"how does Japan differ from China and South Korea on this\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"east_asia | middle_east | western_europe_and_us | south_asia","title":"Region","type":"string"}},"required":["region"],"title":"regional_noteArguments","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}}}}