{"openapi":"3.1.0","info":{"title":"Cashcard API","version":"0.1.0","description":"A hand-curated reference to general cash-vs-card payment norms in 35 countries across every populated region, distinct from tipping norms — covers whether cash or card is expected at all, with comparisons, category/region browsing, a payment-culture glossary, general tips, and a dynamic-currency-conversion warning.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://cashcard.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/cashcard/docs"},"termsOfService":"https://connectorbay.com/cashcard/terms"},"servers":[{"url":"https://cashcard.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/cashcard/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/payment_norms":{"post":{"operationId":"payment_norms","summary":"One country's general cash-vs-card category (cash-preferred, mixed, card-preferred, or near-cashless)","description":"One country's general cash-vs-card category (cash-preferred, mixed, card-preferred, or near-cashless)\n    and practical notes. Use for \"is Japan a cash or card country\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country name.","examples":["Japan","Sweden"],"minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"payment_normsArguments","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":"Lines up several countries' payment norms side by side. Use for \"compare payment culture in Germany,","description":"Lines up several countries' payment norms side by side. Use for \"compare payment culture in Germany,\n    Sweden and France\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"countries":{"description":"2-15 country names to compare.","items":{"type":"string"},"maxItems":15,"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/countries_by_category":{"post":{"operationId":"countries_by_category","summary":"Every covered country in one payment-culture category. Use for \"which countries are basically cashless","description":"Every covered country in one payment-culture category. Use for \"which countries are basically cashless\n    now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"'cash_preferred', 'mixed', 'card_preferred', or 'near_cashless'.","examples":["near_cashless"],"title":"Category","type":"string"}},"required":["category"],"title":"countries_by_categoryArguments","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/countries_by_region":{"post":{"operationId":"countries_by_region","summary":"Every covered country's payment norms in one region.","description":"Every covered country's payment norms in one region.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"'Europe', 'Americas', 'Asia-Pacific', or 'Middle East/Africa'.","examples":["Europe"],"title":"Region","type":"string"}},"required":["region"],"title":"countries_by_regionArguments","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/regions_list":{"post":{"operationId":"regions_list","summary":"The regions this reference covers, with how many countries are in each.","description":"The regions this reference covers, with how many countries are in each.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"regions_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/countries_list":{"post":{"operationId":"countries_list","summary":"Every country this reference has payment-norm data for (35 total, a curated sample, not exhaustive).","description":"Every country this reference has payment-norm data for (35 total, a curated sample, not exhaustive).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"countries_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/payment_glossary":{"post":{"operationId":"payment_glossary","summary":"Defines payment-culture terms: contactless, chip-and-PIN, minimum card purchase, card surcharge, foreign","description":"Defines payment-culture terms: contactless, chip-and-PIN, minimum card purchase, card surcharge, foreign\n    transaction fee, dynamic currency conversion, mobile/QR wallets, and mobile money.","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":"payment_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/general_payment_tips":{"post":{"operationId":"general_payment_tips","summary":"Practical, non-country-specific advice for handling money while travelling — carrying backup cash,","description":"Practical, non-country-specific advice for handling money while travelling — carrying backup cash,\n    notifying your card issuer, and avoiding foreign transaction fees.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"general_payment_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/dcc_warning":{"post":{"operationId":"dcc_warning","summary":"Explains dynamic currency conversion (DCC) — the \"charge/withdraw in your home currency instead?\"","description":"Explains dynamic currency conversion (DCC) — the \"charge/withdraw in your home currency instead?\"\n    prompt at a foreign card terminal or ATM — and why declining it (paying in the local currency) almost\n    always gets you a better exchange rate. Use for \"what's dynamic currency conversion and should I say yes\n    to it\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"dcc_warningArguments","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}}}}