MCP

Integrate Midpage's legal database with AI assistants using the Model Context Protocol.

Note: MCP currently supports court opinion research. Statute and regulation tools are coming soon.

Base URL

https://app.midpage.ai/mcp

Authentication

Midpage supports two authentication models for MCP integrations.

1. API Key

Use API key auth for non-interactive access, server-side jobs, or any integration that should run under one shared credential.

Generate an API key in the Developer Portal. If you need help, contact support@midpage.ai. Then send it in your MCP request headers as:

Authorization: Bearer <api_key>

2. OAuth

Use OAuth when your client should connect each user to their own Midpage account. Each user will need a Midpage account before they can sign in and authorize your client.

For most customers, the easiest setup is:

1. Point your client at https://app.midpage.ai/mcp
2. Let your MCP or OAuth library follow Midpage's discovery metadata and register a client automatically if it supports dynamic client registration
3. Let the user sign in and approve access when prompted

Most MCP clients should not need pre-provisioned OAuth app credentials. Midpage's Clerk auth server supports dynamic client registration, so compatible clients can create their own credentials automatically. If your client cannot do that and needs a pre-provisioned OAuth app, contact Midpage.

GET https://clerk.midpage.ai/oauth/authorize?
  response_type=code&
  client_id=YOUR_CLIENT_ID&
  redirect_uri=https://your-app.com/oauth/callback&
  resource=https%3A%2F%2Fapp.midpage.ai&
  scope=profile%20email%20openid%20offline_access&
  state=RANDOM_VALUE&
  code_challenge=BASE64URL_SHA256(code_verifier)&
  code_challenge_method=S256

curl -X POST "https://clerk.midpage.ai/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "code=AUTHORIZATION_CODE" \
  -d "redirect_uri=https://your-app.com/oauth/callback" \
  -d "resource=https://app.midpage.ai" \
  -d "code_verifier=YOUR_CODE_VERIFIER"

curl -X POST "https://clerk.midpage.ai/oauth/token" \
  -u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "code=AUTHORIZATION_CODE" \
  -d "redirect_uri=https://your-app.com/oauth/callback" \
  -d "resource=https://app.midpage.ai"

Authorization: Bearer <access_token>

Testing in Hosted MCP Clients

If you just want to try Midpage in Claude, Cursor, or another hosted MCP client, add https://app.midpage.ai/mcp and sign in with your Midpage account when prompted.

You can create a free trial account at app.midpage.ai. For production integrations, use API key auth or OAuth as described above.

Available Tools

search

Search US case law across federal and state courts. Returns metadata, highlights, and citator treatment data.

Parameters:

If you filter on publishStatus, consider also running a parallel query with "unknown" because some jurisdictions have missing or uncertain publication metadata.

Example:

{
  "queries": [
    {
      "query": "breach of fiduciary duty elements",
      "jurisdictionType": "state_and_federal",
      "states": ["California"],
      "publishStatus": "published"
    },
    {
      "query": "breach of fiduciary duty elements",
      "jurisdictionType": "state_and_federal",
      "states": ["California"],
      "publishStatus": "unknown"
    }
  ]
}

findInOpinion

Find quotable passages within a single opinion using keyword search.

Parameters:

* Provide one of opinionId, reporterCitation, or docket

Example:

{
  "opinionId": "7228818",
  "query": "minimum contacts purposeful availment"
}

analyzeOpinion

Reads the full document, then answers your question and returns the answer alongside text excerpts.

Accepts either opinionId, reporterCitation, or docket as input.

Parameters:

* Provide one of opinionId, reporterCitation, or docket

Example:

{
  "reporterCitation": "556 U.S. 662",
  "question": "What standard does this case establish for pleading requirements?"
}