mcpField
A
Address Validator X402

Address Validator X402

Remote
github.comMedia & Design0Updated 8w ago

About Address Validator X402

Address Validator X402 is a pay-per-call postal address parsing and validation API for AI agents and applications. It returns structured address components and supports MCP access; payments use x402 with USDC on Base.

Key features

  1. 01Parse, validate, and normalize addresses
  2. 02Detect country and split address components
  3. 03Verify postal codes
  4. 04Pay per call using x402 and USDC on Base

Use cases

  1. 01Clean CRM address records
  2. 02Validate addresses at e-commerce checkout
  3. 03Normalize shipping addresses
  4. 04Verify addresses for KYC

MCP support

It exposes the `address_validate` tool to MCP clients, returning structured address data. The same API is also available over HTTP with x402 pay-per-call payments.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://address-validator.api.klymax402.com/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

Address Validator API

MCP Server x402 License: MIT

Parse and validate postal addresses -- country detection, component split, postal code verification. US/UK/FR/DE. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "address-validator": {
      "url": "https://address-validator.api.klymax402.com/mcp"
    }
  }
}

Quickstart -- HTTP (x402)

curl -X POST "https://address-validator.api.klymax402.com/api/validate" \
  -H "Content-Type: application/json" \
  -d '{"address":"0x0000000000000000000000000000000000dEaD"}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

ToolMethodPathPriceDescription
address_validatePOST/api/validate$0.008Parse, validate, and normalize a postal address
address_validate

Use this when you need to parse, validate, or normalize a postal address. Returns structured address components in JSON.

Parameters

NameTypeRequiredDescription
addressstringyesFull address string to parse and validate (e.g. '123 Main St, New York, NY 10001')

Example response:

{"address":"123 Main St, New York, NY 10001","valid":true,"components":{"street":"123 Main St","city":"New York","state":"NY","postalCode":"10001","country":"United States"},"normalizedAddress":"123 Main St, New York, NY 10001, US","detectedCountry":"United States","postalCodeValid":true,"confidence":0.95}

When to use: CRM data cleaning, e-commerce checkout validation, shipping address normalization, and KYC address verification.

Not for: phone validation (use phone_validate_number), email validation (use email_verify_address), PII detection in text (use compliance_detect_pii).

Example agent prompts

  • "Parse, validate, or normalize a postal address"

Payment

  • Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
  • Network: Base L2 (eip155:8453)
  • Asset: USDC
  • Facilitator: Coinbase CDP (primary), PayAI (fallback)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.