{"uid":"cap_ojfesW2O4OV_7ToYUxkUS","slug":"forgemesh-x402-endpoint-preflight-health-check-1bf483b7","name":"ForgeMesh x402 Endpoint Preflight & Health Check","description":"x402 utility APIs for AI agents: documents/OCR, PDFs, vision, audio, embeddings, web extraction, dictionary and slang lookups, games, chess/legal-move logic, math, conversions, time utilities, market and economic data, space/geo data, domain vetting, content-signal checks, and x402 ecosystem intelligence. Agents POST JSON, receive a 402 challenge, pay USDC on Base, and retry for the result.","url":"https://x402.forgemesh.io/x402-endpoint-preflight","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","description":"x402 endpoint URL to health-check, e.g. https://x402.example.com/some-route"}}},"responseSchema":{"type":"json","example":{"url":"https://library.forgemesh.io/business-management","grade":"A","is_402":true,"findings":["Valid x402 v2 envelope found in the header.","WWW-Authenticate: Payment header also present — this endpoint speaks both x402 and MPP dual-stack, reaching agents on either payment stack."],"reachable":true,"http_status":402,"method_used":"GET","x402_envelope":"header","envelope_valid":true,"mpp_dual_stack":true,"accepts_summary":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x85df5380DEbe236AD6BF49dE788243924B080267","amount":"3000","scheme":"exact","network":"eip155:8453"}],"envelope_errors":[],"response_time_ms":214}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ISUTEAYb8lYoHGhNUpl6a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a given URL is a valid, reachable x402-payment-gated endpoint and returns its payment envelope details, grade, and dual-stack compatibility findings.","exampleAgentPrompt":"Can you run a preflight check on https://x402.example.com/some-route and tell me if it's a properly configured x402 endpoint — what grade it gets, whether it's reachable, and what the payment envelope looks like?","exampleUseCases":[{"title":"Audit newly deployed x402 API","prompt":"I just deployed my API at https://api.myservice.com/premium-data — can you check if its x402 payment configuration is valid and tell me what grade it gets and whether the envelope is well-formed?"},{"title":"Debug a broken x402 payment wall","prompt":"My x402 endpoint at https://x402.myapp.io/inference isn't working right — can you probe it and tell me what errors are in the envelope and whether it's actually reachable?"},{"title":"Check MPP dual-stack compatibility","prompt":"Does https://library.forgemesh.io/business-management support both x402 and MPP dual-stack payments? Run a preflight and tell me exactly which payment schemes and assets it accepts."}],"resultDescription":"Returns a JSON object with a letter grade (e.g. 'A'), reachability flag, HTTP status, response time in ms, whether a valid x402 envelope was found (in header or body), whether MPP dual-stack is supported, a list of human-readable findings, the raw x402 envelope, accepted payment assets and amounts, and any envelope errors detected.","failureModes":["URL is not reachable — reachable: false with no envelope data","URL does not return a 402 status — is_402: false and low grade","Malformed x402 envelope — envelope_valid: false with envelope_errors populated","URL is reachable but has no x402 or payment headers at all — grade may be F","Network timeout or DNS failure on the target URL","Invalid URL format provided in the request body"],"whenToPreferThis":"Use this endpoint when you need to programmatically verify that a specific URL is correctly configured as an x402 payment endpoint — especially before integrating it into an agent workflow, listing it in a directory, or debugging why payments are failing. It is the canonical preflight/health-check tool for the x402 ecosystem, returning structured grading and envelope details that generic HTTP probes cannot provide.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:02:10.611Z","isFirstParty":false}