• GEO
  • TIME
  • SOLAR
  • HUMAN

How to enrich location datasets with your AI

Connect OpenCage to your AI client to turn raw place names into structured geographic data. Once connected, your agent handles the lookup and data formatting for you.

Ask AI about this page

Short answer

How can I add coordinates and solar data to my place names?

Your AI uses OpenCage to convert text-based locations into structured datasets. It pulls in latitude, longitude, timezones, and solar information for every entry. You get a clean, mapped dataset ready for use.

The results.

Where your data lands.

The AI processes your raw text and organizes the results into these specific formats.

GEO

Mapped coordinates

The AI converts names into exact latitude and longitude pairs. This turns a simple list into a map-ready dataset.

TIME

Timezone context

Every location gets its specific timezone attached. This helps your agent understand local time offsets automatically.

SOLAR

Solar data points

The AI appends solar information to each coordinate. You get the specific environmental context needed for location-based logic.

HUMAN

Manual verification

You review the final structured list to ensure the AI matched the place names to the correct physical locations.

The workflow

What your AI does when the list arrives.

The AI follows a sequence to turn text into intelligence.

  1. Find the places

    The AI reads your list of names and finds their exact geographic positions.

    geocode_basic

  2. Get time data

    Once the coordinates are set, the AI pulls the correct timezone information for those spots.

    reverse_fetch_time_annotations

  3. Verify locations

    The AI uses the coordinates to confirm the specific place details and environmental data.

    reverse_basic

  4. Format the output

    The AI organizes the coordinates, timezones, and solar data into a single, clean table or JSON object.

    geocode_basic

Try it

Copy these to start.

Use these prompts to kick off the enrichment process.

Starting points

Swap the bracketed text for your actual file names or specific location lists.

OpenCage Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_WKDzyl3VZM3raWteXPmOlZb4ewVy4fXLQllarGvU/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — OpenCage capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "opencage-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_WKDzyl3VZM3raWteXPmOlZb4ewVy4fXLQllarGvU/mcp"
    }
  }
}
Copy into chat04

  • Enrich the list of cities in my Google Sheet with coordinates and timezones.

  • Take the place names in this text file and add solar data for each one.

  • Convert these addresses into a structured dataset with latitude and longitude.

  • Find the timezones for all the locations listed in my CSV file.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect OpenCage once, then ask.

One click connects the MCP to your client. Your credentials stay encrypted, and you can start asking for data immediately.

Connect OpenCage to your AI

FAQ

How this task behaves.

  • 01

    Can the AI create new locations that don't exist?

    No. The AI can only find and enrich real-world locations that exist in the OpenCage database.

  • 02

    Will the AI change my original files?

    No. The AI generates a new, enriched dataset based on your input; it does not overwrite your source files.

  • 03

    Can I get street addresses too?

    Yes, the AI can retrieve specific address details during the geocoding process.

  • 04

    Does the AI handle bulk uploads?

    Yes, you can provide a large list of names in a file or text block for the AI to process.

  • 05

    Can the AI calculate distances between these points?

    The tools provide coordinates and data, but you must ask the AI to perform the math once the data is enriched.

  • More questions about OpenCage? The Connector page answers them. See everything the OpenCage Connector can do

Connect OpenCage to Claude, Cursor, ChatGPT & more