{"uid":"cap_Gz4wjZJlioeBEYUJz5Xiw","slug":"agente-jefe-x402-protocol-discovery-metadata-diagnostic-847a5e45","name":"agente-jefe x402 Protocol & Discovery Metadata Diagnostic","description":"Why an x402 endpoint fails to charge or appear in the Bazaar: verifies the 402 (version, CAIP-2 network, currency, payTo, amount, window) and the discovery listing without paying. Score, findings with fixes, signed receipt. / Por qué un endpoint x402 no cobra o no aparece en el Bazaar: verifica el 402 (versión, red CAIP-2, moneda, destino, importe, ventana) y la ficha de discovery sin pagar. Puntuación, hallazgos con arreglo y recibo firmado.","url":"https://agente.revenuerecoveryai.app/v1/x402/diagnose","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Endpoint x402 a diagnosticar."},"modo":{"enum":["rapido","completo"],"type":"string"},"incluir_recibo":{"type":"boolean"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"grade":"B","score":82,"receipt":{"signed":true,"endpoint":"/v1/x402/diagnose","algorithm":"Ed25519","issued_at":"2026-08-06T12:00:00+00:00","signature":"...","input_hash":"sha256:0000000000000000000000000000000000000000000000000000000000000000","request_id":"00000000-0000-0000-0000-000000000000","output_hash":"sha256:0000000000000000000000000000000000000000000000000000000000000000","rule_pack_version":"2026.08.07.1","verification_key_id":"ajk_0000000000000000"},"summary":{"info":0,"errors":1,"passed":18,"unknown":0,"warnings":2},"findings":[{"title":"Declara el método HTTP en la ficha","detail":"La ficha no declara input.method. El validador la rechaza y el servicio NO se indexa.","rule_id":"BZR-002","severity":"ERROR","remediation":"Añade 'method' dentro de info.input con el verbo de la ruta."}],"observed":{"url":"https://api.ejemplo.com/v1/datos","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","pay_to":"0x0000000000000000000000000000000000000001","scheme":"exact","network":"eip155:8453","latency_ms":210,"http_status":402,"x402_version":2,"http_status_get":405},"elapsed_ms":640,"report_hash":"sha256:0000000000000000000000000000000000000000000000000000000000000000","analysis_mode":"live_probe","rule_pack_version":"2026.08.07.1","rule_packs_applied":{"x402":11,"bazaar":11},"recommended_actions":[{"title":"Declara el método HTTP en la ficha","action":"Añade 'method' dentro de info.input con el verbo de la ruta.","rule_id":"BZR-002","severity":"ERROR"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8Vm49tgnXPeFRqYXhY5Tx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an x402 payment-gated endpoint without paying — checks protocol correctness (version, CAIP-2 network, currency/network coherence, destination, amount, time window, schema) and Bazaar discovery metadata validity (declared method, schemas, real example, GET-probe compatibility), returning a scored JSON report with prioritized findings and fix guidance.","exampleAgentPrompt":"Run a full diagnostic on my x402 endpoint at https://api.myapp.com/v1/data (GET method) and tell me if the 402 payment protocol and Bazaar discovery metadata are correctly configured — include a signed receipt in the results.","exampleUseCases":[{"title":"Pre-launch x402 compliance check","prompt":"Before I list my new API on the Bazaar, run a complete diagnostic on https://api.myservice.com/v1/premium (GET method) to check whether my x402 payment headers are spec-compliant and my discovery metadata is valid."},{"title":"Debugging 402 network mismatch","prompt":"My x402 endpoint at https://payments.myapp.io/resource (GET) keeps getting rejected by agents — can you do a quick diagnostic to see if the CAIP-2 network and USDC currency declarations are coherent?"},{"title":"Verifying GET probe compatibility","prompt":"I want to make sure my Bazaar-listed endpoint https://api.example.com/gated (HEAD method) passes GET-probe crawler checks — run a full x402 and metadata diagnostic and show me the prioritized list of issues to fix."}],"resultDescription":"A JSON object containing a numeric compliance score (0–1 or 0–100), a prioritized list of findings covering x402 protocol issues (version, CAIP-2 network, currency/network coherence, destination address, payment amount, time window, schema shape) and Bazaar discovery metadata issues (declared HTTP method, input/output schemas, example correctness, GET-probe compatibility), suggested fixes for each finding, and optionally a signed diagnostic receipt. The response is fully deterministic — no LLM inference involved.","failureModes":["Target URL is unreachable or returns a non-402 status — diagnostic cannot proceed","Invalid or missing 'url' query parameter — returns 400 validation error","Target endpoint uses an unsupported HTTP method (POST/PUT/PATCH) — method not diagnosable","Network timeout reaching the target endpoint — partial results or timeout error","Malformed x402 response from target makes schema parsing fail — returns parsing error with details"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, zero-cost (no actual payment sent) compliance check of an x402-gated API — specifically to validate both the low-level payment protocol (CAIP-2, currency, amount, destination, time window) and the high-level Bazaar discovery metadata in a single call. Prefer it over manual inspection or generic HTTP debuggers when you need a scored, actionable report with prioritized fixes. Ideal before listing an endpoint on the Bazaar or troubleshooting agent discovery failures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:45.120Z","isFirstParty":false}