{"uid":"cap_fYmDmHUmSw1FjnP-N2yX0","slug":"specdelta-schema-comparison-22a508c4","name":"SpecDelta Schema Comparison","description":"Detect breaking schema changes and permission expansion between two agent tool specifications.","url":"https://specdelta-kl4hfo6j2q-as.a.run.app/v1/spec/compare","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Qctdm8VdiuuxiOIvzMvza","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Detects breaking changes and permission expansions between two versions of an agent tool specification (MCP, OpenAI tool, or OpenAPI).","exampleAgentPrompt":"Compare these two versions of my OpenAI tool spec and tell me if the new one introduces any breaking changes or unexpected permission expansions — here's the old spec and the new spec.","exampleUseCases":[{"title":"Pre-deploy spec safety check","prompt":"Before I deploy this updated MCP tool spec, compare it against the previous version and flag any breaking changes or permission expansions I should know about."},{"title":"CI pipeline breaking-change gate","prompt":"I've got two versions of my OpenAPI spec — the one currently in production and the new candidate. Can you diff them and tell me if the new version breaks any existing contracts or widens any permissions?"},{"title":"Auditing third-party tool update","prompt":"A third-party agent tool just pushed a new spec version. Compare the old and new specs and let me know if anything breaking changed or if they're requesting broader permissions than before."}],"resultDescription":"A structured report listing detected breaking schema changes (e.g. removed fields, type mismatches, renamed operations) and permission expansions (e.g. newly requested scopes or capabilities) between the two provided specifications, along with severity indicators for each finding.","failureModes":["Invalid or unparseable JSON in either specification returns an error","Specifications of unsupported formats (non-MCP, non-OpenAI, non-OpenAPI) may fail validation","Missing required fields (old or new spec not provided) returns a 400 error","Network timeout or service unavailability returns a 5xx error","Payment failure via x402 protocol blocks the request"],"whenToPreferThis":"Use this endpoint when you need to programmatically detect breaking changes or permission scope creep between two versions of an agent tool specification — especially in CI/CD pipelines, pre-deployment gates, or third-party spec audits. Prefer this over manual diffing or general-purpose schema validators when you specifically need agent-tool-aware semantic diffing (MCP, OpenAI tools, OpenAPI) with a focus on breaking changes and permission expansion rather than just syntactic differences.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:31:47.049Z","isFirstParty":false}