{"uid":"cap_eUgEXS3rSHhJM-GgWChK8","slug":"genesis-agent-tools-webhook-signature-verifier-fb4750e8","name":"GENESIS Agent Tools — Webhook Signature Verifier","description":"Pay-per-call x402 APIs for autonomous agents on Base USDC: API compatibility analysis, bounded HTTP/JSON workflows, URL evidence analysis, crypto price consensus, and agent/MCP readiness checks.","url":"https://genesis-agent-tools.genesisagenttools.workers.dev/api/tools/webhook-signature-verify?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["body","secret","signature"],"properties":{"body":{"type":"string"},"secret":{"type":"string"},"signature":{"type":"string"}}},"responseSchema":{"type":"object","properties":{"valid":{"type":"boolean"}}},"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_xhkpVGZQVWCKvc8hYac8I","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":"Verifies that a webhook signature matches the expected HMAC or similar signature derived from a shared secret and request body.","exampleAgentPrompt":"Can you verify this webhook signature for me — the body is '{\"event\":\"payment.completed\",\"amount\":100}', the shared secret is 'whsec_abc123xyz', and the signature is 'sha256=abcdef1234567890'?","exampleUseCases":[{"title":"Validate incoming payment webhook","prompt":"I just received a webhook from our payments provider with body '{\"event\":\"charge.succeeded\",\"id\":\"ch_001\"}' and signature 'sha256=deadbeef1234'. My webhook secret is 'whsec_myPaymentSecret'. Can you verify it's legitimate before I process the order?"},{"title":"Authenticate CI/CD pipeline event","prompt":"My CI system sent a webhook with body '{\"ref\":\"refs/heads/main\",\"pusher\":\"alice\"}' and the signature header is 'sha256=9f8e7d6c5b4a'. The shared secret configured is 'ci_secret_token_xyz'. Please check if the signature is valid."},{"title":"Verify third-party alert integrity","prompt":"We got an inbound alert webhook with body '{\"alert\":\"cpu_high\",\"host\":\"prod-1\"}' signed as 'sha256=112233aabbcc' using our monitoring secret 'mon_secret_987'. Can you confirm whether the signature checks out before we trigger the incident response?"}],"resultDescription":"Returns a JSON object with a single boolean field 'valid' — true if the provided signature matches what is computed from the body and secret, false otherwise.","failureModes":["Missing required fields (body, secret, or signature) results in a 400 error","Signature mismatch returns {\"valid\": false} without an error","Invalid or malformed signature format may return false or a parsing error","Payment failure (x402) if USDC balance is insufficient","Network timeout or Cloudflare Worker cold start latency on rare occasions"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, pay-per-call webhook signature verification step inside an autonomous agent workflow, especially when you want to avoid standing up your own HMAC verification service. Particularly suited for agent pipelines built on the x402 micropayment protocol with Base USDC, where you only pay $0.01 per verification and don't need to maintain infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:48:47.402Z","isFirstParty":false,"canonicalSlug":"genesis-agent-tools-webhook-signature-verifier-fb4750e8"}