MCP Changelog

Midpage MCP versioned endpoints let integrations pin a tool contract:

  • MCP v4: https://app.midpage.ai/mcp/v4 (current)
  • MCP v3: https://app.midpage.ai/mcp/v3
  • MCP v2: https://app.midpage.ai/mcp/v2
  • MCP v1: https://app.midpage.ai/mcp/v1

The unversioned endpoint, https://app.midpage.ai/mcp, serves the current contract, v4.

v4

V4 exposes search, analyzeCaseDocument, analyzeCaseDocket, searchLaws, and analyzeLaw.

  • search merges up to four queries into one deduplicated result set, with composable court/state/date filters, exact document types, publication-status filtering for opinions, partial-result handling, and cursor continuation.
  • analyzeCaseDocument handles both opinions and filings, returning qualified propositions, source-extracted quotes, reader links, source warnings, and the Negative or Caution citing opinions behind a treatment flag. It replaces analyzeOpinion, findInOpinion, and analyzeDocketFiling in v4.
  • analyzeCaseDocket replaces analyzeDocketReport, answering from metadata and recorded activity while exposing coverage, freshness, and reusable filing references. case.url is the reader/citation link; docketReport.downloadUrl is the report download.
  • The laws tools retain their v3 contracts. V3 docket tools keep their premium gate; v4 can read stored material without that upfront gate, while PACER acquisition remains metered.
  • Opinion caseName and citation in search and analyzeCaseDocument use the opinion's short title when known, otherwise the docket caption, and document.opinion adds perCuriam and enBanc, each present only when true. Reader URLs are unchanged (added 2026-09-25).

See the v4 reference and migration guide.

v3

MCP v3 adds federal docket tools and laws tools:

  • analyzeDocketReport
  • analyzeDocketFiling
  • analyzeLaw — question-driven analysis of statutes, regulations, constitutions, and agency guidance by citation/register citation/path/id, returning verified verbatim passages, with current-law resolution, children navigation, and version chains (added 2026-07-04)
  • searchLaws — full-text search over the laws corpus with state/type/code filters and per-state hit counts for surveys (added 2026-07-05)

The opinion research tools are unchanged from v2:

  • search
  • findInOpinion
  • analyzeOpinion

At the v3 release, the unversioned endpoint moved to v3. Integrations that only need the stable opinion research contract can stay pinned to https://app.midpage.ai/mcp/v2.

v2

MCP v2 keeps the same three tools:

  • search
  • findInOpinion
  • analyzeOpinion

The search and findInOpinion tool contracts are unchanged.

analyzeOpinion changes its output contract:

v1 v2
supportedPropositions[].pinCiteUrl supportedPropositions[].deeplinkURL
No disposition field Required disposition field
No supportedPropositions[].opinionSection field Optional supportedPropositions[].opinionSection field

Use the MCP v2 docs for the complete v2 contract.

v1

MCP v1 is the original stable contract. Use MCP v1 if your integration depends on supportedPropositions[].pinCiteUrl or has not yet migrated to v2.