81trust / 100

A2a Card Validate

by A2A Agent Card validate in Security & trust

x402 APIPassing, checked 38 min ago

Validate an A2A (Agent2Agent protocol) Agent Card: required fields, skill shape, transport names, capability flags - spec v0.3 structural core. Returns errors, interop warnings, and a normalized summary (skills, interfaces, capabilities). Deterministic mini-A2A tooling - check a card before your agent trusts it.

POST https://agent402.tools/api/a2a-card-validate

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
185 ms typical, 185 ms slowest 5%
Last check
38 min ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X POST "https://agent402.tools/api/a2a-card-validate" \
  -H "content-type: application/json" \
  -d '{"card":{"capabilities":{"pushNotifications":false,"stateTransitionHistory":false,"streaming":true},"defaultInputModes":["application/json","text/plain"],"defaultOutputModes":["application/json"],"description":"A sample A2A Agent Card served as a static example for card tooling. This describes a fictional weather agent, not a live A2A endpoint.","name":"Sample Weather Agent","preferredTransport":"JSONRPC","protocolVersion":"0.3.0","provider":{"organization":"Example Org","url":"https://example.com"},"skills":[{"description":"Returns a city's 5-day forecast.","examples":["What is the weather in Paris this week?"],"id":"get-forecast","name":"Get weather forecast","tags":["weather","forecast"]}],"url":"https://example.com/a2a/v1","version":"1.0.0"}}'
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fagent402.tools%2Fapi%2Fa2a-card-validate
const res = await pay("https://agent402.tools/api/a2a-card-validate", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"card":{"capabilities":{"pushNotifications":false,"stateTransitionHistory":false,"streaming":true},"defaultInputModes":["application/json","text/plain"],"defaultOutputModes":["application/json"],"description":"A sample A2A Agent Card served as a static example for card tooling. This describes a fictional weather agent, not a live A2A endpoint.","name":"Sample Weather Agent","preferredTransport":"JSONRPC","protocolVersion":"0.3.0","provider":{"organization":"Example Org","url":"https://example.com"},"skills":[{"description":"Returns a city's 5-day forecast.","examples":["What is the weather in Paris this week?"],"id":"get-forecast","name":"Get weather forecast","tags":["weather","forecast"]}],"url":"https://example.com/a2a/v1","version":"1.0.0"}}),
});
console.log(await res.json());

Example input

{
  "card": {
    "capabilities": {
      "pushNotifications": false,
      "stateTransitionHistory": false,
      "streaming": true
    },
    "defaultInputModes": [
      "application/json",
      "text/plain"
    ],
    "defaultOutputModes": [
      "application/json"
    ],
    "description": "A sample A2A Agent Card served as a static example for card tooling. This describes a fictional weather agent, not a live A2A endpoint.",
    "name": "Sample Weather Agent",
    "preferredTransport": "JSONRPC",
    "protocolVersion": "0.3.0",
    "provider": {
      "organization": "Example Org",
      "url": "https://example.com"
    },
    "skills": [
      {
        "description": "Returns a city's 5-day forecast.",
        "examples": [
          "What is the weather in Paris this week?"
        ],
        "id": "get-forecast",
        "name": "Get weather forecast",
        "tags": [
          "weather",
          "forecast"
        ]
      }
    ],
    "url": "https://example.com/a2a/v1",
    "version": "1.0.0"
  }
}

Example output

{
  "errors": [],
  "summary": {
    "name": "Sample Weather Agent",
    "skillCount": 1
  },
  "valid": true,
  "warnings": []
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
38 min agoPassed402185 ms$0.002
6 h agoPassed402190 ms$0.002