# Address Validator

> Address Validator is a paid MCP server for freight and logistics. Pay-per-request delivery address validation with geocoding and a deliverability score. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, self-hosted
- **Website:** https://kder-ai.com
- **Repository:** https://github.com/kder974/address-validator
- **MCP Registry name:** io.github.Kder974/address-validator
- **Categories:** freight and logistics, maps and travel
- **Listing updated:** 2026-11-15

## About

The service takes a raw delivery address and returns a standardised one with line1, line2, city, state, zip and country, corrected by the upstream provider when the address is recognised, such as fixed spelling, city or an added postal code. It also returns latitude and longitude from Nominatim geocoding, a deliverability value, a confidence figure, a degraded flag and a cache key. The documentation is written in French.

Each validation costs 0.02 USDC by default under the x402 protocol: POST /validate answers 402 Payment Required until a valid proof of payment is supplied. The README says on-chain confirmation is on by default and requires a confirmed USDC transfer on Base to the collection wallet. Repeated identical addresses are served from a cache without calling the provider again.

If the provider is unreachable the API still answers 200 with degraded set to true instead of implying an address is invalid. Rate limiting is done at the Nginx edge at 10 requests per second per IP. The site root returns a small JSON index pointing to docs, manifest, health, MCP and pricing.

## Features

- **Address standardisation:** Returns a corrected address split into line1, line2, city, state, zip and country.
- **Geocoding:** Adds latitude and longitude from Nominatim.
- **Deliverability score:** Returns deliverability and confidence values for each address.
- **x402 payment:** Calls are refused with 402 until valid payment proof is provided.
- **Result caching:** Repeated addresses return a cache key without a second provider call.
- **Degraded mode:** Provider outages produce a fast, flagged response instead of a false invalid result.

## Good for

- Check a shipping address at checkout before dispatch
- Normalise messy addresses in an order import
- Geocode customer addresses for routing
- Let an agent pay per address validation with USDC
- Flag low-confidence addresses for manual review

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http address-validator https://kder-ai.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://kder-ai.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "address-validator": {
      "url": "https://kder-ai.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "address-validator": {
      "type": "http",
      "url": "https://kder-ai.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "address-validator": {
      "serverUrl": "https://kder-ai.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "address-validator": {
      "type": "http",
      "url": "https://kder-ai.com/mcp"
    }
  }
}
```

## FAQ

### How much does a validation cost?

0.02 USDC by default, paid through the x402 protocol.

### What happens if the provider is down?

The API returns 200 with degraded set to true rather than an error.

### What does it return?

A standardised address, coordinates, deliverability, confidence, a degraded flag and a cache key.

### Which network is payment on?

The README says USDC on Base is confirmed on-chain.

### What are the rate limits?

The README says Nginx allows 10 requests per second per IP with a burst of 20.

### Is Address Validator free?

No. Address Validator is a paid product.

### How do I add Address Validator to Claude Code?

Run this command in your terminal: claude mcp add --transport http address-validator https://kder-ai.com/mcp

### What are the best alternatives to Address Validator?

The closest alternatives to Address Validator are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Lane Cost freight rates and Zentria Flow.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Lane Cost freight rates](https://ai-powered.com/mcp/lane-cost-freight-rates): Lane Cost freight rates is a free MCP server for freight and logistics.
- [Zentria Flow](https://ai-powered.com/mcp/zentria-flow): Zentria Flow is a freemium MCP server for freight and logistics.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Cofinal](https://ai-powered.com/mcp/cofinal): Cofinal is a paid MCP server for freight and logistics.

---
Source: https://ai-powered.com/mcp/address-validator
