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.
searchmerges 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.analyzeCaseDocumenthandles 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 replacesanalyzeOpinion,findInOpinion, andanalyzeDocketFilingin v4.analyzeCaseDocketreplacesanalyzeDocketReport, answering from metadata and recorded activity while exposing coverage, freshness, and reusable filing references.case.urlis the reader/citation link;docketReport.downloadUrlis 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
caseNameandcitationinsearchandanalyzeCaseDocumentuse the opinion's short title when known, otherwise the docket caption, anddocument.opinionaddsperCuriamandenBanc, each present only whentrue. 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:
analyzeDocketReportanalyzeDocketFilinganalyzeLaw— 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:
searchfindInOpinionanalyzeOpinion
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:
searchfindInOpinionanalyzeOpinion
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.