• VALID
  • LOW SCORE
  • WRONG COUNTRY
  • INVALID

How to validate delivery addresses with your AI

Connect OpenCage to your AI client to clean up shipping data. Your agent handles the heavy lifting of checking locations and scoring accuracy.

Ask AI about this page

Short answer

How can I use AI to check if my delivery addresses are real?

Your AI uses OpenCage to check addresses against real-world maps. It filters by country and assigns a confidence score to every location to flag errors. You'll see exactly which addresses are safe to ship and which need a human to fix them.

The results.

Where your data lands.

The AI sorts every address into one of these four categories.

VALID

Ready to ship

The AI finds a high-confidence match. These addresses go straight to your fulfillment queue.

LOW SCORE

Needs a human

The AI found a partial match but the confidence score is too low. You'll need to manually check these before sending them out.

WRONG COUNTRY

Filtered out

The address doesn't match your specified country filter. The AI catches these immediately to prevent international shipping errors.

INVALID

Unrecognized location

The geocoding attempt failed to find any match. These are clearly typos or fake addresses that should be discarded.

The workflow

What your AI does when an address arrives.

Your agent follows a specific sequence to ensure every coordinate is accurate.

  1. Filter by region

    The AI first checks if the address belongs in the correct country to prevent cross-border mistakes.

    geocode_country_filter

  2. Find the location

    The agent looks up the address details to turn text into usable geographic data.

    geocode_basic

  3. Score the match

    The AI evaluates how certain it is that the address actually exists.

    geocode_high_confidence

  4. Flag the errors

    The agent compares the results against your rules and highlights the bad data.

    geocode_high_confidencegeocode_country_filter

Try it

Copy these to start.

Use these prompts to kick off the validation process.

Starting points

Swap the bracketed text for your actual data sources like a Google Sheet or a CSV file.

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

  • Check the addresses in my 'orders.csv' file and flag anything that doesn't match the US.

  • Run a high-confidence check on the customer list in this Google Sheet.

  • Look at these new shipping entries and tell me which ones have low confidence scores.

  • Validate the addresses in my Shopify export and filter out anything outside of Canada.

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

Start here

Connect OpenCage once, then ask.

Just link your account once. Your credentials stay encrypted, and you can start asking your AI to validate addresses immediately.

Connect OpenCage to your AI

FAQ

How this task behaves.

  • 01

    Can the AI automatically update my database with the new addresses?

    No. The AI only reads and validates the data. You must manually approve the changes or use a different tool to write to your database.

  • 02

    Will the AI delete any of my existing customer records?

    No. This MCP only performs geocoding and filtering. It has no capability to delete or modify your original files.

  • 03

    How does it decide if an address is 'high confidence'?

    It uses the geocode_high_confidence tool to compare the input against known map data and returns a score based on the match quality.

  • 04

    Can I restrict searches to a specific country?

    Yes. You can use the country filter to ensure the AI only validates addresses within your target region.

  • 05

    What happens if the AI can't find an address at all?

    The AI will report that the address is invalid or unrecognized, allowing you to catch the error before shipping.

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

Connect OpenCage to Claude, Cursor, ChatGPT & more