Pay-per-call checks for AI agents

Verify before you act.

The shield for your agent's token budget and your money. One HTTP call, one exact JSON answer, before money moves, an invoice goes out or a deadline is promised. Deterministic code instead of reasoning tokens. Paid per call in USDC, no account.

Browse all routes and pricesAgent overview (llms.txt)

Why call it

Fewer expensive mistakes

A wrong IBAN, a miscalculated VAT amount or a deadline that forgot a public holiday costs far more than the check. Every bundle returns ok plus each failed field.

Fewer tokens

Checksums, tax rates, holidays and business days are exact in code. Reasoning them out is slow, costs more and can be wrong.

Safe to try

Out-of-scope input returns 404 before payment, so a bad call never burns budget. The free choose_route tool says pay, compute or skip first.

Free gatekeeper: choose_route

Worried an agent will pay for something trivial? Before any paid call, the agent asks choose_route on /mcp with one sentence. It answers pay, compute or skip. It is free, it never spends money and it does not return the fact itself. Pay only on pay.

Start with these

GET /transfer0.02 USDC

Verify before money moves: IBAN, BIC, amount, SEPA scope, remittance text and name in one call. ok plus failed fields. Does not confirm the holder.

GET /invoice0.03 USDC

Verify before an invoice is sent or paid: net + VAT = gross, VAT vs rate, IBAN, VAT id, date, number. ok plus failed fields. Not an XRechnung schema check.

GET /fields0.04 USDC

Verify required fields before an invoice is sent. Peppol BIS Billing 3.0 mandatory terms from the May 2026 structure page. Unknown profile is not charged. Not arithmetic.

GET /routing0.05 USDC

Verify a German BLZ, Swiss IID, or Banxico SPEI clave against the operator file before money moves. Not the SWIFT BIC directory. Unknown system is not charged.

GET /deadline0.01 USDC

Verify before you promise a date: add business days skipping weekends and public holidays of a country or region.

GET /holidays0.008 USDC

Verify before you schedule: every statutory public holiday of a year for a country or region. Replaces recalling a list from memory.

GET /cryptopay0.01 USDC

Verify before you send stablecoins: recipient checksum, zero or token-contract recipient, native USDC/USDT contract on that chain. Not a balance or sanctions screen.

GET /settle0.02 USDC

Verify before you promise when money arrives: TARGET, Fedwire, or CHAPS settlement day and the next value date. A year with no date returns that year's closing days. Not a bank cutoff.

GET /value0.03 USDC

Verify before you promise a Lynx, ACSS, Real-Time Rail, SIC, or euroSIC value date. TARGET, Fedwire, and CHAPS are /settle. Unknown system or a date outside the named source is not charged.

GET /vies0.08 USDC

EU VIES answer for a VAT id at request time. Not a checksum and not a certificate. A silent registry is not charged.

GET /iban0.005 USDC

IBAN checksum, length, and country format. Does not confirm the account exists.

POST /lines0.01 USDC

Receipt photo to JSON line items. The image is not stored.

All routes with live prices →

Example of a paid answer: GET /holiday?country=DE&date=2026-10-03 returns {"known":true,"holiday":true,"name":"Tag der Deutschen Einheit"}

What the answers look like

Every bundle returns ok and the list of failed fields, so it drops straight into if/else logic. Real responses:

GET /invoice with a wrong VAT amount

{
  "known": true,
  "ok": false,
  "net": "100.00", "vat": "20.00", "gross": "119.00",
  "rate_percent": 19, "expected_vat": "19.00",
  "failed": ["sum", "vat_amount"],
  "checks": [
    {"field": "sum", "ok": false,
     "note": "net + vat is 120.00, gross says 119.00."},
    {"field": "vat_amount", "ok": false,
     "note": "VAT should be 19.00 at 19% of net, invoice says 20.00."}
  ]
}

GET /transfer with a bad IBAN and a foreign BIC

{
  "known": true,
  "ok": false,
  "iban_country": "DE",
  "sepa_country": true,
  "failed": ["iban", "bic_country"],
  "checks": [
    {"field": "iban", "ok": false,
     "note": "IBAN checksum fails."},
    {"field": "bic_country", "ok": false,
     "note": "BIC country FR differs from IBAN country DE."}
  ]
}

GET /deadline 5 business days from 2026-12-22, Bavaria

{
  "known": true,
  "result": "2026-12-30",
  "weekday": "Wednesday",
  "skipped_holidays": [
    {"date": "2026-12-25", "name": "1. Weihnachtstag"}
  ],
  "skipped_weekend_days": 2
}

GET /cryptopay recipient is a token contract

{
  "known": true,
  "ok": false,
  "chain": "Base",
  "failed": ["recipient_not_token_contract"],
  "note": "Funds sent to a stablecoin contract
           are usually lost."
}

The payment handshake

x402 is plain HTTP. Mainnet checks settle on Base. A rehearsal on Base Sepolia is at /try.md. Those five paths are not the paid bundles. The cheapest mainnet route costs 0.001 USDC. Unknown input and a missing required field return 404 before payment and cost nothing. That 404 sends X-AgentShield-Retryable: false. Do not sign it.

1. GET /iban?iban=DE89370400440532013000
   ← 402 Payment Required
      header PAYMENT-REQUIRED: amount, asset USDC, network eip155:8453, payTo

2. sign the payment with your own key (pay-client.mjs, or any x402 client)

3. GET /iban?iban=DE89370400440532013000
   header PAYMENT-SIGNATURE: <signed payment>
   ← 200 OK  {"known":true,"valid":true,...}  header PAYMENT-RESPONSE: settlement

System-prompt snippet

No MCP router needed. Paste this into your agent's system prompt:

Before you move money, send or pay an invoice, promise a date, assume a holiday
calendar, promise when a bank payment arrives, or send stablecoins, call
agentshield.live instead of reasoning it out. Use /transfer, /invoice, /fields, /routing, /deadline,
/holidays, /cryptopay, /settle, /value. Invoice numbers are /invoice; required Peppol fields are /fields; a German BLZ, Swiss IID, or Banxico SPEI clave is /routing, not the SWIFT BIC directory; a receipt photo is
/lines. A year of holidays is /holidays; one date is /holiday. A USDC address is
/cryptopay. Find any other route with https://agentshield.live/catalog/search?q=
or ask choose_route on https://agentshield.live/mcp. Pay only when choose_route
says pay. A 404 with X-AgentShield-Retryable: false is not a charge: do not sign.
Trust ok:false and fix the listed failed fields. Rehearse payment on Base Sepolia
at https://agentshield.live/try.md. Those routes are not the production checks.

Cost comparison (estimate)

TaskA model doing itagentshield.live
Validate an IBAN~500–1,500 reasoning tokens, digit errors possible/iban 0.005 USDC, exact
Due date in 10 business days, Bavarian holidays~1,000–3,000 tokens, holiday errors common/deadline 0.01 USDC, exact
Bank transfer: IBAN, BIC, amount, SEPA textSeveral steps, easy to skip one/transfer 0.02 USDC, one call
Invoice: totals, VAT, IBAN, VAT idMulti-step arithmetic plus format rules/invoice 0.03 USDC, one call
Invoice required fields before sendThe Peppol mandatory list is easy to shorten from memory/fields 0.04 USDC, one call
National clearing code before a paymentThe SWIFT BIC directory is the wrong file, and the national lists are not in memory/routing 0.05 USDC, one call
Receipt photo to line itemsVision call, free-form output to re-parse/lines 0.01 USDC, JSON

Speed: a paid call took about 1.0–1.4 s end to end including payment settlement (measured 2026-11-12 from one host, 3 calls each on /iban and /deadline). The route itself answers in milliseconds, and an unpaid 402 came back in under 10 ms. A reasoning model working through the same check step by step usually needs several seconds (estimate).

Token counts are rough estimates for a reasoning model working step by step. At typical output prices of 10–25 USD per million tokens, 1,000 tokens cost about 0.01–0.025 USD. Route prices come from the live HTTP 402.

Use it from an agent

  1. 1
    Call choose_route on /mcp with one sentence. It returns pay, compute or skip.
  2. 2
    On pay, request the URL. The server answers HTTP 402 with the exact price.
  3. 3
    Pay with your own key (pay.md) and repeat the request. You get JSON.
X402_PAYER_KEY=your_key node pay-client.mjs "Check this IBAN before sending money"

Using a framework? Both snippets were run against the live service with a real payment. They use your own wallet key; it never leaves your machine.

Python: LangChain / LangGraph / CrewAI
# pip install "x402[evm,httpx]" langchain-core eth-account
import os, json, httpx
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm.exact import register_exact_evm_client
from x402.mechanisms.evm.signers import EthAccountSigner
from langchain_core.tools import tool

BASE = "https://agentshield.live"
x402 = x402Client()
register_exact_evm_client(x402, EthAccountSigner(Account.from_key(os.environ["X402_PAYER_KEY"])), networks="eip155:8453")

@tool
async def check_iban(iban: str) -> dict:
    """Check an IBAN (checksum, length, country format) before money moves."""
    async with x402HttpxClient(x402) as c:   # pays the 402 automatically, 0.005 USDC
        return (await c.get(f"{BASE}/iban", params={"iban": iban})).json()

@tool
async def choose_route(task: str) -> dict:
    """Free. Is this subtask worth paying for? Returns pay, compute or skip."""
    async with httpx.AsyncClient() as c:
        r = await c.post(f"{BASE}/mcp", json={"jsonrpc": "2.0", "id": 1, "method": "tools/call",
            "params": {"name": "choose_route", "arguments": {"task": task}}})
        return json.loads(r.json()["result"]["content"][0]["text"])

# tools = [choose_route, check_iban]  -> pass to your LangChain / LangGraph / CrewAI agent
TypeScript: Vercel AI SDK
// npm i agentshield-live ai zod
import { tool } from "ai";
import { z } from "zod";
import { createAgentShield } from "agentshield-live";

const shield = createAgentShield({ maxUsdc: 0.05 });   // reads X402_PAYER_KEY, hard per-call cap

export const agentshield = {
  check_transfer: tool({
    description: "Check a bank transfer before money moves: IBAN, BIC, amount. Returns ok and failed fields.",
    inputSchema: z.object({ iban: z.string(), amount: z.string().optional() }),
    execute: (args) => shield.call("agentshield_transfer", args),   // 0.02 USDC
  }),
  choose_route: tool({
    description: "Free. Is this subtask worth paying for? Returns pay, compute or skip.",
    inputSchema: z.object({ task: z.string() }),
    execute: ({ task }) => shield.call("agentshield_choose", { task }),
  }),
};
// generateText({ model, tools: agentshield, prompt })

Install

The old agentshield-audit skill is not this product. Neither is useagentshield.ai or the Solo.io agentshield project. Smithery is shut. A Hermes-only listing does not exist; Hermes uses the same MCP endpoint.

Good to know

Answers are deterministic and stored, not live: no market prices or scores, and no claim that an account exists or that money is owed. This is not a firewall, security audit or certificate, and there is no grade.

Budget tip: set a daily spending limit in the agent's wallet, for example 1 USDC, so a prompt loop cannot drain it. Most routes cost well under a cent.