Global Locale · composite

Cross-border checkout quote: FX conversion into the destination currency, VAT/GST, postal-code validation and EU reverse-charge eligibility

GET /v1/cross-border-checkout-composite on geo.caelaralabs.com

$0.025USDC per call
GETcomposite tier
3 / 7Required params
Parameters

Request parameters

NameInTypeRequiredDescription
amountquerynumberyesOrder subtotal in the source currency
currencyquerystringyesSource currency ISO 4217 code, e.g. USD
countryquerystringyesDestination country (ISO alpha-2, e.g. DE)
postal_codequerystringnoDestination postal code to validate
prices_include_taxquerystringnotrue when the amount already includes tax
vat_idquerystringnoBuyer VAT ID for B2B reverse-charge screening (format only, not VIES-verified)
origin_countryquerystringnoSeller country (ISO alpha-2) for reverse-charge screening
cURL

Call it with an API key

Send your key as X-Caelara-Key. Responses are JSON; when an upstream source is unavailable the API still answers HTTP 200 with "partial": true instead of a server error.

curl -s "https://geo.caelaralabs.com/v1/cross-border-checkout-composite?amount=10&currency=example&country=US" \ -H "X-Caelara-Key: $CAELARA_KEY"
MCP

Use it as an MCP tool

Tool name cross_border_checkout_composite on the remote server https://geo.caelaralabs.com/mcp (registry ID com.caelaralabs/geo). MCP tool calls need an X-Caelara-Key API key; to pay per call in USDC, use the direct HTTP route in the x402 section below.

{ "mcpServers": { "caelara-geo": { "type": "http", "url": "https://geo.caelaralabs.com/mcp", "headers": { "X-Caelara-Key": "${CAELARA_KEY}" } } } }
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "cross_border_checkout_composite", "arguments": { "amount": 10, "currency": "example", "country": "US" } } }
x402

Pay per call in USDC on Base

No account needed. An unauthenticated request returns HTTP 402 with an X-Payment-Required: x402 header and a JSON body whose accepts entry carries scheme exact, network base, maxAmountRequired 25000 (0.025 USDC, 6 decimals), the USDC asset and the payTo address. Settlement happens only after a successful response.

# 1. Unpaid call: HTTP 402 with header X-Payment-Required: x402 curl -si "https://geo.caelaralabs.com/v1/cross-border-checkout-composite?amount=10&currency=example&country=US" # 2. Pay 0.025 USDC (25000 atomic units) on Base mainnet # asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 # payTo see the 402 response: accepts[0].payTo # 3. Retry with the signed payment payload curl -s "https://geo.caelaralabs.com/v1/cross-border-checkout-composite?amount=10&currency=example&country=US" \ -H "X-PAYMENT: $X402_PAYMENT_B64"