postal_code_lookup
City, state, and geo-coordinates for a postal/zip code. Supports 60+ countries via Zippopotam.
What is postal_code_lookup?
postal_code_lookup is a paid MCP tool in the Government category on agenttoll.dev. It costs $0.02 per call, settled in USDC on Base via the x402 payment protocol. No API keys, no accounts — your agent discovers it via /.well-known/agent.json, calls it, pays the $0.02 fee, and receives structured JSON.
Input parameters
{
"country": "2-letter ISO code e.g. US, GB, DE",
"postal_code": "string postal code"
}
Example usage
{
"country": "US",
"postal_code": "90210"
}
HTTP endpoint
POST to this path with JSON body. Server returns 402 with x402 payment requirements.
/paid/gov/postal-lookup
How to call postal_code_lookup
Connect any MCP-compatible client (Claude Desktop, Cursor, custom agent) to the agenttoll.dev MCP endpoint:
https://agenttoll.dev/mcp
Or call the HTTP endpoint directly with an x402-capable fetch client.
Pricing & payment
FAQ
How much does postal_code_lookup cost?
$0.02 per call in USDC on Base. No subscriptions or minimums.
Do I need an API key?
No. Payment is handled by the x402 protocol. Your agent wallet sends USDC on Base, the server verifies the transfer, and returns the data.
Which AI models work with postal_code_lookup?
Any model that supports MCP — Claude, GPT-4, Gemini, or local models via an MCP client. The tool returns structured JSON that any model can parse.
How do I verify my payment?
After settlement, check /receipt/<tx> for on-chain verification via Basescan. Every payment is a real USDC transfer to 0x62a0D3d9…
