{"uid":"cap__ADsSVksSSXeUpj6i3ICv","slug":"coco-country-lookup-9a1c943b","name":"CoCo Country Lookup","description":"Zach Riehn's lab: an about-me and portfolio, a news desk, The Atelier for AI experiments, Launch Lab for XRP research, and Fracture for games.","url":"https://cocoeatsai.com/area4/agent/tools/country?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"enum":["GET"]},"queryParams":{"type":"object","properties":{"query":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"const":"json"},"example":{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"flag":"🇺🇸","name":"United States","alpha_2":"US","alpha_3":"USA","numeric":"840","official_name":"United States of America","subdivision_count":57,"subdivisions_sample":["US-WV","US-PA","US-MP","US-HI","US-WY","US-PR","US-MS","US-AK","US-IA","US-RI","US-MT","US-ID","US-AL","US-SC","US-NC"]},"exampleNote":"Computed offline with demonstration inputs; time/random values are illustrative."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A2m6_KZwH8gaxEfq3adu5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up country metadata (name, flag, ISO codes, subdivision count, and sample subdivisions) for a given country query string","exampleAgentPrompt":"What are the ISO codes, flag, and subdivision count for Japan?","exampleUseCases":[{"title":"Enrich user profile with country metadata","prompt":"I have a user who selected 'Germany' from a dropdown — can you pull the full country metadata including the ISO alpha-2 and alpha-3 codes, the flag emoji, and how many subdivisions it has?"},{"title":"Validate and normalize country input","prompt":"A customer typed 'United States of America' in our form — look it up and give me the standardized ISO codes and official name so I can store it consistently."},{"title":"Display country flag and details in UI","prompt":"I need to show a flag emoji and the official name for Brazil on a profile page — can you fetch that country's details?"}],"resultDescription":"Returns a JSON object with the country's flag emoji, common name, ISO alpha-2 code, ISO alpha-3 code, numeric code, official name, total subdivision count, and a sample list of subdivision codes (e.g. US state or province codes).","failureModes":["Ambiguous query string may return unexpected country (e.g. 'Georgia' could match the country or a US state context)","Unknown or misspelled country names may return no results or an error","Very short or non-Latin query strings may not resolve correctly","Rate limiting or payment failure may block the request"],"whenToPreferThis":"Use this endpoint when you need structured ISO 3166 country metadata — including flag emoji, official name, alpha-2/alpha-3 codes, numeric code, and subdivision count — from a free-text country query. It is well-suited for normalizing user-supplied country names, enriching records with ISO codes, or displaying country details in a UI. Prefer it over manual ISO table lookups or general geocoding APIs when you specifically need country-level ISO data with subdivision info.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:43:26.821Z","isFirstParty":false,"canonicalSlug":"coco-country-lookup-9a1c943b"}