# Geocodio — MCP server on mcp.ai
> Connect your Geocodio account and use 7 tools for developer tools straight from your AI agent. Connect with your own API key. Geocodio provides straightforward and easy-to-use geocoding, reverse geocoding, and data matching services for US and Canadian addresses.

By: mcp.ai · official
Page: https://mcp.ai/geocodio

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_geocodio?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/geocodio/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/geocodio/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/geocodio/skill.md
Postman collection (v2.1): https://mcp.ai/geocodio/postman.json

## Tools
- geocodio_batch_reverse_geocode(limit?: integer, fields?: string, coordinates: string[]) — Tool to batch reverse geocode up to 10,000 coordinates in one request. Use when you need addresses for many lat/lon pairs.
- geocodio_delete_list(list_id: integer) — Permanently deletes a Geocodio spreadsheet list by its ID. Use this to cancel a processing list job or remove a completed list. This action is destructive and cannot be undone. The list_id must be obt
- geocodio_geocode_batch(limit?: integer, fields?: string, addresses: string[], destinations?: string[], distance_mode?: string, distance_units?: string, distance_order_by?: string, distance_sort_order?: string, distance_max_results?: integer, distance_max_distance?: number, distance_max_duration?: integer, distance_min_distance?: number, distance_min_duration?: integer) — Tool to batch geocode up to 10,000 addresses to coordinates in one request. Use when you need to convert multiple addresses to lat/lon coordinates. Optionally calculates distances to specified destina
- geocodio_geocode_google_maps_compatible(key: string, latlng?: string, address?: string) — Tool to geocode addresses using Google Maps-compatible API format. Use when you need a drop-in replacement for Google Maps Geocoding API for US and Canada addresses.
- geocodio_get_coordinates_for_batch_reverse_geocode() — Utility tool that returns a predefined list of sample US coordinates (latitude,longitude strings). Use this to obtain ready-to-use coordinate inputs for the batch reverse geocode action. The coordinat
- geocodio_single_geocode(q?: string, city?: string, limit?: integer, state?: string, county?: string, fields?: string, format?: string, street?: string, country?: string, street2?: string, postal_code?: string) — Tool to forward geocode a single address. Use when you need coordinates and metadata for one address.
- geocodio_single_reverse_geocode(lat: number, lng: number, limit?: integer, fields?: string, format?: string) — Tool to reverse geocode a single coordinate. Use when you need to convert one lat,lng to an address.

## Example prompts
- "What can I do in Geocodio?"
- "Show me a summary of my Geocodio account"

## Links
Docs: https://mcp.ai/docs/mcps/geocodio
Website: https://mcp.ai/mcps/geocodio