Return country facts — capital, currency (name, code, symbol), phone code, timezone, region, subregion, flag emoji, and languages — for countries that match a search query, an ISO 3166-1 alpha-2 code, or a region. Call with no filters to list every country.
This page documents the HTTP endpoint POST /api/tools/country-lookup/execute. See the MCP reference →
Call it over REST
POST https://api.findutils.com/api/tools/country-lookup/execute · no API keys · 60 requests/min per IP
Execute — verified arguments
curl -X POST https://api.findutils.com/api/tools/country-lookup/execute \
-H "Content-Type: application/json" \
-d '{
"code": "TR"
}' Parameter schema for this endpoint
curl https://api.findutils.com/api/tools/country-lookup Input schema
| Argument | Type | Required | Description |
|---|---|---|---|
| query | string | no | Country name, capital, currency name or code (e.g. USD), phone code (e.g. +90), timezone, or language to search for. |
| code | string | no | Exact ISO 3166-1 alpha-2 code, e.g. "TR", "US". Case-insensitive. |
| region | string (Africa | Americas | Asia | Europe | Oceania) | no | Restrict to one region. |
| limit | integer | no | Maximum number of countries to return (1-300). Default 25. Default: 25. |
Example arguments (verified)
{
"code": "TR"
} Also an MCP tool
Claude, Cursor, and any MCP client can call this tool as
findutils:country_lookup after one connect command.
Connect once
claude mcp add findutils --transport http https://mcp.findutils.com/ More Datetime tools
Age Calculate
Calculate age from a date of birth — years, months, days, plus totals in days, weeks, and months.
Career Experience Calculator
Calculate total professional experience across several jobs: total days, years/months/days, weeks, working days (5/7), working hours (8 per
Cron Describe
Parse a 5- or 6-field cron expression and produce a human-readable description.
Date Difference
Compute the difference between two dates in years/months/weeks/days/hours/minutes/seconds.
Date Difference Calculator
Calculate the difference between two dates in various units.
Relationship Calculator
Calculate how long a relationship has lasted between a start date and a target date: years/months/days, totals in days, weeks, months, hours
Timezone Convert
Convert a datetime between IANA time zones.
Unix Timestamp Convert
Convert between Unix timestamps and ISO dates.