{"uid":"cap_1wMEVJqw5Y7O7CUQMVZsH","slug":"osa-agent-spend-preflight-1c34963b","name":"OSA Agent Spend Preflight","description":"Paid machine API for live API/MCP provider reliability decisions.","url":"https://187-124-119-223.sslip.io:8443/api/agent-preflight","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"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":120,"minLength":2,"description":"API, MCP server, provider, or category to evaluate"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","decision","query"],"properties":{"ok":{"type":"boolean"},"query":{"type":"string"},"reason":{"type":"string"},"decision":{"enum":["ALLOW","HOLD","DENY"],"type":"string"},"confidence":{"type":"number"},"alternatives":{"type":"array","items":{"type":"object"}},"best_provider":{"type":["object","null"]}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"query":"mcp","reason":"best_live_trust_score_82","decision":"ALLOW","confidence":0.91,"alternatives":[],"best_provider":{"name":"example-provider","status":"active"}}},"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":"down","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_BFHXmcuI-SkitEN884ppc","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":"Evaluates the live reliability and trustworthiness of an API, MCP server, or provider and returns an ALLOW/HOLD/DENY routing decision with confidence score.","exampleAgentPrompt":"Before calling the OpenAI MCP server, run a preflight reliability check on it and tell me whether I should allow, hold, or deny the request — and how confident you are.","exampleUseCases":[{"title":"Preflight check before paid API call","prompt":"Before my agent spends money calling the Anthropic API, check if it's currently reliable and give me a trust decision — ALLOW, HOLD, or DENY."},{"title":"Find best provider for a category","prompt":"I want to use a text embedding provider but I'm not sure which one is live and trustworthy right now — can you evaluate the 'embeddings' category and tell me the best option?"},{"title":"Vet an unfamiliar MCP server","prompt":"I found a new MCP server called 'brave-search' — can you run a preflight reliability check on it and tell me if it's safe to route my agent traffic there?"}],"resultDescription":"Returns a JSON object with: a boolean 'ok' field, the original query, a routing 'decision' of ALLOW/HOLD/DENY, a numeric confidence score (0-1), a human-readable reason code, a 'best_provider' object with name and status, and an 'alternatives' array of fallback providers.","failureModes":["Query string too short (under 2 chars) or too long (over 120 chars) — input validation error","Unknown or unrecognized provider/API name — low confidence result with possible DENY","Provider data stale or unavailable — may return HOLD decision","Network timeout reaching the preflight service — HTTP 5xx error","Payment not completed (x402) — request blocked before evaluation"],"whenToPreferThis":"Use this endpoint when an AI agent needs a real-time, live reliability signal before committing to a paid or critical API/MCP call. Prefer it over static provider lists or hardcoded routing logic when you need a dynamic ALLOW/HOLD/DENY verdict with a confidence score. Especially valuable for agentic workflows where wrong provider selection wastes money or causes downstream failures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T21:26:36.096Z","isFirstParty":false}