您的 AI 代理可以自行付费的地址验证。

三次调用完成

与 HTTP 相同的服务，接入您的代理已经在用的协议。

1. 免费发现

   /.well-known/mcp-server 卡片描述服务器。在 /mcp 上调用 initialize 和 tools/list 完全免费。

2. 获取报价

   未付款的 tools/call 会返回一个错误工具结果（isError），其中是准确的 x402 v2 报价：网络、USDC 代币、金额（20000 个单位，即 0.02 USDC）和收款地址。

3. 付款，然后获得结果

   代理签署授权（EIP-3009），并将付款放入 params._meta["x402/payment"] 再次调用（v1 客户端也可使用 X-PAYMENT 请求头）。结算完成后返回结果与收据。

MCP 客户端配置

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

调用工具

POST https://kder-ai.com/mcp
{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "validate_address",
    "arguments": { "address": {
      "street": "1600 Amphitheatre Parkway", "city": "Mountain View",
      "state": "CA", "zip": "94043", "country": "US" } }
  }
}

工具结果中的报价

"accepts": [{
  "scheme": "exact", "network": "eip155:8453",
  "amount": "20000",
  "asset": "USDC", "payTo": "0x…"
}]

从代码中付款

x402 官方库会自动读取报价、签名并付款，x402 v1 和 v2 均适用。设置支出上限，然后像调用其他 API 一样调用即可。

Python · x402 + httpx

# pip install "x402[httpx,evm]"
import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

async def main():
    client = x402Client().set_spend_controls({"max_amount_per_payment": "$0.05"})
    signer = EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"]))
    register_exact_evm_client(client, signer)
    async with x402HttpxClient(client) as http:
        response = await http.post("https://kder-ai.com/validate", json={"address": {
            "street": "1600 Amphitheatre Parkway", "city": "Mountain View",
            "state": "CA", "zip": "94043", "country": "US"}})
        await response.aread()
        print(response.status_code, response.json())

asyncio.run(main())

JavaScript · @x402/fetch

// npm install @x402/fetch @x402/evm viem, then run as an ES module (pay.mjs)
import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls({ maxAmountPerPayment: "$0.05" });
client.register("eip155:*", new ExactEvmScheme(privateKeyToAccount(process.env.EVM_PRIVATE_KEY)));

const pay = wrapFetchWithPayment(fetch, client);
const response = await pay("https://kder-ai.com/validate", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ address: {
    street: "1600 Amphitheatre Parkway", city: "Mountain View",
    state: "CA", zip: "94043", country: "US" } }),
});
console.log(response.status, await response.json());

代理收到的内容

JSON 响应，格式始终一致。

• validated地址是否被识别
• standardizedline1、line2、city、state、zip、country
• latitude · longitude地址的 GPS 坐标
• deliverabilityresidential、commercial…
• confidence0 到 1 的置信度
• degraded为 true：数据提供方未响应，请重试

为什么代理适合用 x402

无需创建账户，无需保存密钥，无需订阅：代理只为实际用量付费，用多少付多少。已使用过的授权会被拒绝：同一笔付款绝不会计算两次。

须知

• 美国地址由 USPS（DPV）核验，法国及海外省由国家地址库（BAN）核验；其他地区仍为部分验证。
• degraded 为 true 表示数据提供方没有响应：这不是错误地址，请稍后再调用。
• 每个 IP 地址每秒不超过 10 个请求。
• 地址不会保存在日志中；结果会在缓存中保留 30 天，以便更快响应。
• 没有钱包的网店可以用 API 密钥和订阅使用同一服务。

常见问题

集成指南 价格 价格对比