Name: country-info
Price: 0.002 USDC
Availability: InStock

$ man country-info

agentutility / locale / country-info

PRICE / CALL

$0.002

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

country-info — country info / iso 3166 / country code lookup / capital city lookup / currencies by country / population / region resolver

SYNOPSIS

POST https://x402.org/v1/country-info
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Country info / ISO 3166 / country code lookup / capital city lookup / currencies by country / population / region resolver. Resolves country metadata by common name, ISO 3166 alpha-2/alpha-3 code, or capital city, returning name, codes, capital, region, subregion, population, area (km²), currencies, languages, timezones, flag emoji, neighboring-country codes, and international calling code. Wraps the public REST Countries v3.1 API — no auth, commercial-OK.

INPUT — request schema

property	type	description	req?
query	string	Search string — country name (e.g. 'Germany'), ISO code (e.g. 'DE'), or capital city (e.g. 'Berlin'), depending on query_type.	required
query_type	string	How to interpret 'query'. Default 'name'. enum: name · code · capital	optional

OUTPUT — response shape

field	type	description
matches	string	Array of matched country records with name, codes, capital, region, population, currencies, languages, and flag emoji.
source	string	Upstream data source identifier, typically 'restcountries.com v3.1'.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/country-info \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the country-info tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: localecountry-infoiso-3166country-codecapital-lookupcurrenciesgeo-metadatarest-countries
methods: POST
cluster: locale
price: $0.002 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
astro-times	sunrise-sunset / golden-hour / civil twilight / nautical dusk / day-length / solar-noon / dawn-dusk / astronomy times.	$0.002
earthquakes-recent	Earthquake feed / seismic activity / USGS / recent quakes / quake monitor / tremor data / fault line activity / tsunami alerts.	$0.002
holiday-lookup	Public holidays / bank holidays / national holidays / federal holidays / holiday calendar / per-country dates.	$0.002
sunrise-sunset	Sunrise sunset times.	$0.002
timezone-convert	Timezone convert / IANA tz conversion / DST-aware time arithmetic / wall-clock to UTC / convert across cities.	$0.001
timezone-lookup	Timezone lookup / IANA tz / UTC offset / DST status / local time at lat-lng / which timezone.	$0.001
iata-airport-info	IATA / ICAO airport code lookup.	$0.005
satellite-tile	Satellite imagery tile / lat-lon to satellite PNG / Sentinel-2 tile API / cloud-free satellite snapshot / agent-callable satellite imagery.	$0.005

/country-info(1)