Currency and Country Metadata
lookup_currencyRead-only currency and country metadata lookup via GET /v3/ipgeo. Works on free and paid plans. Cost: 1 credit per successful lookup.
Instructions
Read-only currency and country metadata lookup via GET /v3/ipgeo. Works on free and paid plans. Cost: 1 credit per successful lookup.
Returns { currency, country_metadata }: currency code/name/symbol plus country calling_code, tld, and languages. ip selects the IP used to derive country and currency; omit it for the server machine's public egress IP. force_refresh bypasses cached data, makes a new upstream request, and can consume credits.
This response is limited to currency and country metadata. lookup_ip can return these fields together with other IP data.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "lookup_currency"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ip | No | IPv4 or IPv6 address whose country determines the returned currency and country metadata. Omit to use the server's public egress IP. | |
| force_refresh | No | Default false. When true, bypasses cached currency/country data; a successful refresh makes a new upstream request and can consume credits. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Present on success: API result after field selection, redaction, and transport limits. | |
| page | No | ||
| error | No | Present on failure, with isError: true. |