Summary
The source repository is pretty bare, no README or documentation visible, but the concept is clear enough. This handles postal address validation through a remote API endpoint at klymax402.com. You'd use it when you need to parse messy address strings, verify they match expected postal formats, or detect which country an address belongs to before processing it further. The "x402" suffix and specific API domain suggest this is tied to a particular validation service rather than a generic library. Useful if you're building forms, processing shipping data, or cleaning up address databases and want Claude to handle the validation logic without rolling your own parser for every country's postal quirks.
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Tools
Public tool metadata for what this MCP can expose to an agent.
1 tools
address_validateUse this when you need to parse, validate, or normalize a postal address. Returns structured address components in JSON. Returns: 1. components (street, city, state, postalCode, country) 2. valid (bo1 params
Use this when you need to parse, validate, or normalize a postal address. Returns structured address components in JSON. Returns: 1. components (street, city, state, postalCode, country) 2. valid (bo
Parameters* required
addressstringFull address string to parse and validate (e.g. '123 Main St, New York, NY 10001')
Address Validator API
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
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
address_validate | POST | /api/validate | $0.003 | Parse, 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
| Name | Type | Required | Description |
|---|---|---|---|
address | string | yes | Full 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.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Featured
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →