# Geocode.xyz MCP for AI Agents AI Agent Connect

> Geocode.xyz MCP converts addresses into coordinates, performs reverse geocoding, and extracts location data from text. It handles IP geolocation and provides smart autocomplete for accurate data entry. It gives your AI agent the ability to process geographic information instantly.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_YMP5yr72ClOYHPbkGdAG4fut8bUvsypCNjyAPgwg/ai-agent-connect
- **Tags:** geocoding, reverse-geocoding, geoparsing, location-data, ip-geolocation

## Description

Geocode.xyz lets you turn physical addresses into precise coordinates and extract location data from messy text. It is built for people who need to handle geographic information without the manual headache of copying data between tabs. If you are cleaning a large dataset of customer locations, you can just tell your agent to grab the coordinates for you. It handles the lookups and returns the data in one go. For content teams, it can scan a long article and pull out every city or landmark mentioned. This turns a tedious research task into a simple command. Because Vinkius hosts this Connector, you can plug it into your existing agent workflow and get started immediately. It handles the heavy lifting of mapping so you can focus on the actual work. You get a way to give your AI spatial awareness without having to manage complex APIs yourself.

## Tools

### geoparse
Identify and extract location names from free-form text. It handles long text blocks to find every mentioned place.

### ip_geolocation
Locate an IP address geographically. This tells you the city and country for any given IP.

### reverse_geocode
Convert latitude and longitude coordinates into a physical address. Use this to find out what is at a specific GPS point.

### autocomplete
Provide suggestions for partial street names, postal codes, or city names. It helps fix typos and partial entries.

### forward_geocode
Convert a place name or address into geographic coordinates. This is the primary way to get lat/long from a string.

## Prompt Examples

**Prompt:** 
```
Find the coordinates for 'The Colosseum in Rome'.
```

**Response:** 
```
I've located the Colosseum. The coordinates are:

* **Latitude:** 41.8902
* **Longitude:** 12.4922
```

**Prompt:** 
```
What address is located at latitude 48.8584 and longitude 2.2945?
```

**Response:** 
```
The coordinates 48.8584, 2.2945 correspond to the **Eiffel Tower**, located at:

Champ de Mars, 5 Avenue Anatole France, 75007 Paris, France.
```

**Prompt:** 
```
Extract all locations from this text: 'Our team is traveling from New York to London next week.'
```

**Response:** 
```
I've parsed the text and found two locations:

1. **New York** (USA)
2. **London** (United Kingdom)
```

## Capabilities

### Convert addresses to coordinates
Turn any physical address or landmark into precise latitude and longitude points.

### Find addresses from coordinates
Identify the nearest physical address or point of interest from a set of GPS coordinates.

### Extract locations from text
Automatically find and pull geographic location names out of unstructured blocks of text.

### Look up IP locations
Determine the city and country associated with a specific IP address.

### Get location suggestions
Receive autocomplete suggestions for partial street names, postal codes, or cities.

## Use Cases

### Cleaning a messy CSV of customer addresses
A data analyst asks the agent to take a list of 1,000 messy addresses and return a table of clean coordinates using forward_geocode.

### Verifying remote delivery points
A logistics manager provides a set of coordinates and asks the agent to find the nearest street address using reverse_geocode.

### Extracting locations from a travel guide
A content creator feeds a 50-page PDF to the agent and asks it to extract every city and landmark mentioned using geoparse.

### Identifying visitor regions
A marketing lead asks the agent to check an IP address and return the city and country using ip_geolocation.

## Benefits

- Stop manual data entry by using forward_geocode to instantly turn addresses into usable coordinates.
- Clean up messy datasets with autocomplete to ensure your location data is standardized and accurate.
- Save hours on content tagging by letting your agent use geoparse to pull locations from large documents.
- Verify delivery points quickly with reverse_geocode to confirm that GPS coordinates match real-world addresses.
- Enrich your user data with ip_geolocation to automatically identify the country or city of your visitors.

## How It Works

The bottom line is your AI agent gets a direct line to global geographic data.

1. Enter your Geocode.xyz API key in the configuration settings.
2. Connect the Connector to your preferred AI client via the Vinkius dashboard.
3. Ask your agent to geocode an address, find a location, or parse a text block.

## Frequently Asked Questions

**Can Geocode.xyz MCP help me clean my address list?**
Yes, it uses autocomplete and forward_geocode to standardize your addresses and turn them into usable coordinates.

**How does Geocode.xyz MCP handle messy text?**
It uses geoparse to scan through paragraphs and pull out location names automatically, even if they are buried in long sentences.

**Can I use Geocode.xyz MCP to find an address from GPS?**
Yes, reverse_geocode converts latitude and longitude coordinates into a physical street address for you.

**Does Geocode.xyz MCP work for international addresses?**
Yes, it provides global geographic intelligence for cities and landmarks all over the world.

**How do I get the country of a visitor with Geocode.xyz MCP?**
The ip_geolocation tool identifies the city and country associated with an IP address, which is great for localized content.

**Does Geocode.xyz MCP support partial addresses?**
Yes, the autocomplete tool provides suggestions for partial street names or postal codes to help fix typos during data entry.

**Can I extract multiple location names from a long paragraph of text?**
Yes! Use the `geoparse` tool. Provide the text in the `scantext` parameter, and the agent will identify and return all geographic locations mentioned within that text.

**How do I find the address for a specific set of GPS coordinates?**
Use the `reverse_geocode` tool. Simply provide the `lat` (latitude) and `long` (longitude) values, and the server will return the closest physical address.

**Is it possible to locate a user based on their IP address?**
Yes, the `ip_geolocation` tool allows you to input an IP address and retrieve the associated city, region, and country data.