Mcp Contract-check
Inspect one public MCP HTTP endpoint, auto-detect the stateless 2026-07-28 era or fall back to the legacy initialize lifecycle, then normalize tools/list schemas into a deterministic SHA-256 contract fingerprint. Forest never invokes an advertised tool or attempts authentication.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
$0.004 / callPOST /mcp/contract-checkx402 · Base
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- check the tool contract exposed by this MCP server before an agent uses it
- fingerprint MCP tool schemas for CI or compatibility checks
- verify a modern or legacy MCP tools list without invoking any tool
What Forest guarantees
- bounded read-only MCP protocol discovery plus tools/list only; no tools/call
- 2026-07-28 server/discover support with bounded fallback to the legacy initialize lifecycle
- deterministic SHA-256 fingerprint over normalized tool names and input/output schemas when the list is complete
- no authentication attempt, paid request, settlement or business-data mutation
Boundaries
- tool runtime behavior, side effects or semantic correctness
- authenticated tool catalogs or non-HTTP MCP transports
- a complete fingerprint when tools/list reports pagination; paginated results fail closed with a null hash
- full JSON Schema standards compliance beyond bounded structural contract validation
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.
Input example
{
"url": "https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/fixtures/mcp"
}
Canonical paid endpoint
https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/mcp/contract-check
Related capabilities
- Mcp Changed — Auto-detect a public MCP endpoint era, fingerprint its complete normalized tools/list schema contract and optionally compare it with a caller-provided previous SHA-256 hash. Cosmetic descriptions are excluded so text-only edits do not trigger contract drift.
- Mcp Discover — Find public MCP server candidates and registry metadata.
- Mcp Preflight — Read-only MCP handshake/tools-list preflight; no destructive tool calls.
- Json Validate — Validate caller-supplied JSON against Forest bounded JSON Schema subset v1 before an agent trusts or forwards structured output. Returns deterministic machine-readable violations with stable paths; performs no network request, remote $ref resolution, regex evaluation, model inference or mutation.
- Docs Discover — Discover machine-readable integration documentation from a public developer/docs page: llms.txt, Markdown alternates, API/auth docs, OpenAPI or Swagger specifications, and MCP candidates. Candidates are returned only after bounded verification. Maximum 10 HTTP requests; no JavaScript, recursive crawl or authenticated content.
- Job Form-schema — Return structured application fields/questions where publicly exposed.