Connect Zipcodebase to Your AI Agent

Provide postal codes and a country when asking AI about location or distance.

7 tools API key

Try a Zipcodebase Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Zipcodebase

Look Up Postal Code Locations

Look up a set of postal codes and explain the city, region, and coordinates available in the response.

/oo Zipcodebase: Look up postal codes [codes: an array of postal-code strings] and explain the returned location details.

Compare Postal Code Distances

Compare an origin postal code with other codes in a country and report the selected distance unit.

/oo Zipcodebase: Calculate distance from postal code [code] to postal codes [compare: an array of strings] within country [country: two-letter ISO code], using [unit: km or mile]. Explain the returned units.

Start Working with Zipcodebase

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect Zipcodebase

Connect with your Zipcodebase API Key.
Connect Zipcodebase →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

Supported postal codes and their country codes for location and distance queries.
Postal-code distances are location calculations, not driving routes or guaranteed delivery areas.

Zipcodebase Tools

Look up a set of postal codes and explain the city, region, and coordinates available in the response. Compare an origin postal code with other codes in a country and report the selected distance unit.

Look Up Postal Code Locations

Look up location information for one or more postal codes.

Compare Postal Code Distances

Calculate distance from one postal code to one or more comparison postal codes.

7 tools

Get Status

Return Zipcodebase account status and remaining request credits.

zipcodebase.get_status

Search Postal Codes

Look up location information for one or more postal codes.

zipcodebase.search_postal_codes

Calculate Distance

Calculate distance from one postal code to one or more comparison postal codes.

zipcodebase.calculate_distance

List Postal Codes Within Radius

List postal codes located within a radius of a postal code.

zipcodebase.list_postal_codes_within_radius

Match Postal Codes By Distance

Find submitted postal code pairs that are within a given distance.

zipcodebase.match_postal_codes_by_distance

List Postal Codes By City

List postal codes associated with a city and optional state or province.

zipcodebase.list_postal_codes_by_city

List Postal Codes By State

List postal codes associated with a state or province.

zipcodebase.list_postal_codes_by_state

Frequently Asked Questions

What can AI help me do with Zipcodebase?

Resolve postal codes to locations and compare geographic distances using Zipcodebase.

What should I know before using Zipcodebase results?

Postal-code distances are location calculations, not driving routes or guaranteed delivery areas.

What do I need to connect Zipcodebase?

Connect a Zipcodebase API key and prepare supported postal codes. Distance queries require a two-letter country code and an array of comparison codes.