7Maps · Paying
Give your agent a wallet
The first 20 route and road_conditions calls a day are not charged. After that, an agent pays per call in USDC on Base through x402, by itself, within a limit you set. Setup takes a few minutes.
Claude Code, Codex, Gemini CLI, Claude Desktop
Coinbase Payments MCP adds a wallet to your agent. You set the spending limits in the wallet app, and the agent cannot change them.
- Install it and pick your client when asked:
npx @coinbase/payments-mcp
For Claude Code without the prompt:npx @coinbase/payments-mcp --client claude-code --auto-config
- Open the wallet, set the limits, and add a few dollars of USDC on Base.
- Ask your agent to use 7Maps. When the day's calls without charge are used, it pays the per-call price shown in the 402 answer.
Docs: Coinbase Agentic Wallet quickstart · coinbase/payments-mcp. Wallets that pay plain HTTP x402 endpoints can call every 7Maps tool at POST https://7it.co.il/7maps/x402/<tool> (OpenAPI).
Your own agent (Node.js)
The official x402 client pays any 402 answer automatically. Fund the wallet with only what you are willing to spend: its balance is the limit.
npm install @x402/fetch @x402/evm viem
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";
const account = privateKeyToAccount(process.env.AGENT_WALLET_KEY);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});
const res = await pay("https://7it.co.il/7maps/x402/route", {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({ task: "send a transactional email" }),
});
console.log(await res.json());
Package: @x402/fetch. Keep the key in an environment variable, never in code you commit.
Prices
| Tool | Per call |
|---|---|
route (20 a day not charged) | $0.01 |
road_conditions (20 a day not charged) | $0.002 |
watch | $0.005 |
preflight | $0.003 |
tool_card, verify_lock, changes_since | $0.002 |
Current prices are always returned by list_paid_tools and /.well-known/x402. A call that fails is not charged. Placement on the map cannot be bought.