gtm.devdocs
resolve & enrich

Location normalization API

resolve_geo

0.1 credits / call

Canonicalize a free-text place — a country code or name ("US", "United Kingdom"), a city ("Bengaluru"), or a state/region ("Karnataka") — to the canonical geo labels used across the company and hiring indexes. Returns the country (with ISO-2 code), a [city, region, country] hierarchy when uniquely resolvable, and candidates[] when the name is ambiguous (e.g. "Springfield").

Get an API key 1,000 free live credits · no card

Parameters

paramtypedescription
query requiredstringPlace to resolve, e.g. "Bengaluru", "US", "United Kingdom", "Karnataka".

Call it from your agent (MCP)

Connect once and resolve_geo appears in your agent’s toolbox next to every other gtm.dev tool. Claude Code:

claude mcp add --transport http gtm https://mcp.gtm.dev \
  --header "Authorization: Bearer YOUR_API_KEY"

Under the hood, the client sends:

curl -X POST https://mcp.gtm.dev \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"resolve_geo","arguments":{"query":"Bengaluru"}}}'

other clients (cursor, claude desktop, openai agents sdk, langchain): mcp setup

Call it over REST

curl -X POST https://api.gtm.dev/v1/tools/resolve_geo \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Bengaluru"}'

Errors (401, 402, 429, 400) are listed in the REST reference. Calls that error are not billed — see pricing.

Related tools