{"uid":"cap_lviNkheeTrfkpAPn9HOj7","slug":"agent-card-discovery-decision-490cb404","name":"Agent Card Discovery Decision","description":"Agent card discovery decision fetches current public evidence from the supplied target and evaluates the documented criterion. It returns the observation, threshold, verdict, exact evidence source, limitations and a mode-specific action. The check is passive: no login attempt, payload injection, exploit, purchase, form submission or load test is performed.","url":"https://agentreadiness.halowerk.com/v1/agent-card-decision?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"target":{"type":"string","maxLength":2048,"minLength":3,"description":"Public HTTP(S) URL or domain to inspect. A bare domain is normalized to HTTPS."},"context":{"type":"object","description":"Optional non-secret correlation labels returned unchanged only in the request lifecycle.","maxProperties":12,"additionalProperties":{"type":["string","number","boolean","null"]}},"baseline":{"type":["object","null"],"description":"Optional baseline returned by a previous snapshot call.","additionalProperties":true},"compare_url":{"type":"string","maxLength":2048,"minLength":3,"description":"Optional public comparison URL. Used by change and monitoring services."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ts55foYMTAvab7GJMmKTV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches public evidence from a target URL and evaluates whether it exposes a valid agent card, returning a verdict, evidence source, threshold, and recommended action.","exampleAgentPrompt":"Check if https://api.example.com has a valid agent card — I need to know if it's discoverable by AI agents, what evidence was found, and what I should do next.","exampleUseCases":[{"title":"Pre-integration agent card check","prompt":"Before I integrate with https://payments.acme.com, can you verify whether they have an agent card published? I want to see the verdict and where the evidence came from."},{"title":"AI readiness audit for own domain","prompt":"Audit my site at https://myservice.io and tell me if it passes the agent card discovery check — I want to know the observation, any limitations, and what action I should take."},{"title":"Comparing two domains for agent card support","prompt":"Compare https://platform-a.com and https://platform-b.com to see which one has a better agent card setup — give me the verdict and evidence source for each."}],"resultDescription":"Returns an observation describing what was found at the target, the evaluation threshold, a pass/fail verdict, the exact evidence source URL, any limitations of the passive check, and a mode-specific recommended action. No login, form submission, or active probing is performed.","failureModes":["Target URL is unreachable or returns non-200 status — verdict may be inconclusive","Agent card path exists but is malformed — observation notes the issue but verdict may still fail","Domain normalization fails for non-standard URLs — request rejected with validation error","Rate limits or network timeouts during passive fetch — partial or no evidence returned","Target blocks crawlers — evidence source unavailable, limitations noted in response"],"whenToPreferThis":"Choose this endpoint when you need a passive, read-only check specifically for agent card presence and validity on a public URL. Prefer it over general crawling or manual inspection when you need a structured verdict with evidence sourcing and actionable guidance. Use it as a pre-integration step before connecting to a third-party service, or as part of an automated AI readiness audit pipeline. It complements sibling endpoints for OpenAPI discovery, llms.txt, and header semantics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T18:30:35.817Z","isFirstParty":false,"canonicalSlug":"agent-card-discovery-decision-490cb404"}