Pledr Legal MCP documentation
Pledr Legal MCP lets an AI assistant such as Claude search real Supreme Court of India judgments and answer with the actual citation, paragraph numbers and a link to the official source. This page explains how to connect it, what the tool returns, the usage limits, and how your data is handled.
Connect to ChatGPT
- Open the Pledr Legal listing in ChatGPT's plugin directory and click Install plugin.
- Sign in with Google or your email and click Allow access. Pledr never sees or stores your password.
- Start your question with "Use Pledr Legal to …", for example: "Use Pledr Legal to find a Supreme Court precedent on anticipatory bail once a charge-sheet is filed."
To add it by URL instead, in ChatGPT open Plugins, click Add, then Add custom MCP server, enter the server URL https://legal.pledr.in/mcp, choose OAuth sign-in if asked, and sign in.
Plugin availability and menu names can differ between ChatGPT plans, countries and versions.
Connect to Claude
- Open the Pledr listing in the Claude connector directory, or in Claude go to Settings → Connectors → Discover and search for "Pledr".
- Click Add, then Connect, and sign in with Google or your email. Pledr never sees or stores your password.
- Ask Claude a legal research question, for example: "Use Pledr Legal to find a Supreme Court precedent on anticipatory bail once a charge-sheet is filed." Naming Pledr Legal at the start of your question helps your assistant choose the right tool.
To add it manually instead, choose Add custom connector, name it Pledr Legal and enter the server URL https://legal.pledr.in/mcp.
Setup guides for Perplexity, Grok and Cursor are on the tutorial page. Release history is on the changelog.
Authentication
Pledr Legal uses OAuth 2.0 with PKCE. Sign-in is handled by WorkOS AuthKit, which acts as the authorization server; the Pledr server only verifies the tokens it issues.
| Item | Detail |
|---|---|
| Flow | Authorization code with S256 PKCE. Each user signs in with their own account (Google, an emailed code, or email and password). Authorization is per user. |
| Client registration | Client ID Metadata Documents, with Dynamic Client Registration (RFC 7591) as the fallback. No static client ID or secret is needed, and no callback URL has to be allowlisted by us: clients register their own redirect URIs. |
| Discovery | An unauthenticated request to https://legal.pledr.in/mcp returns HTTP 401 with a WWW-Authenticate header that points to the protected-resource metadata at https://legal.pledr.in/.well-known/oauth-protected-resource (resource https://legal.pledr.in). The authorization server metadata is at https://suitable-train-97.authkit.app/.well-known/oauth-authorization-server. |
| Scopes | openid, email and profile identify the signed-in account so usage limits apply per account. offline_access issues a refresh token so users are not asked to sign in repeatedly. There are no data scopes: Pledr does not access the user's Google or other accounts. |
| Tokens | Access tokens are signed JWTs (RS256) issued by WorkOS. On every request the server verifies the signature, issuer, audience and expiry. An invalid or expired token returns HTTP 401 with the discovery header, so the client refreshes or signs in again. |
| Revocation | The server verifies tokens itself without calling WorkOS on each request, so a revoked session stops working when its current access token expires. To close an account or have data removed, write to support@pledr.in. |
Tool reference: search_judgments
Pledr Legal MCP provides one tool. It is read-only: it searches and returns text and never changes any data. It is annotated as read-only and non-destructive so that clients can run it without a confirmation prompt.
Parameters
| Name | Type | Description |
|---|---|---|
query | string, required | A legal scenario, a statute or section (for example Section 438 CrPC), or a case citation (for example 2026 INSC 145). Up to 2,000 characters. |
top_k | integer, optional | Number of results to return. Default 10, maximum 20. |
year | string, optional | A 4-digit year from 2000 to the current year to restrict the search. Leave out to search all years. |
What each result contains
| Field | Meaning |
|---|---|
citation, case_number, petitioner, respondent, judgment_date | Identifies the judgment. |
paragraph_numbers | The paragraph(s) of the judgment the text comes from. |
chunk_text | The matching text, taken directly from the judgment. |
pdf_source_url | Link to the official judgment PDF. |
statute_labels | Statutes and sections the passage refers to. |
relevance_score | Ranking score between 0 and 1. Higher means a closer match. |
note | A short AI-generated summary of the case: issue, held, ratio. This can contain errors. |
usage | Your searches used today, your daily limit, searches remaining, and when the limit resets. |
reranked | true normally. false means the results were ordered without the final re-ranking step because that step was temporarily unavailable. |
Example
query: "anticipatory bail after charge-sheet filed Section 438"
year: "2026"
result:
citation: 2026 INSC 145 (Sumit v. State of U.P.)
paragraph_numbers: 16
chunk_text: "... no restriction in Section 438 Cr.P.C. to grant anticipatory
bail even when charge sheet has been filed ..."
pdf_source_url: https://api.sci.gov.in/supremecourt/2026/3119/...
usage: { used_today: 1, daily_limit: 30, remaining_today: 29 }Usage limits
Limits apply to each signed-in account and protect the service for everyone.
| Plan | Daily searches | Burst |
|---|---|---|
| Free (early access) | 30 per day | 6 per minute |
- The day resets at 12:00 AM India Standard Time.
- Only successful searches count. A search that fails or is rejected for invalid input does not use your allowance.
- Every response shows how many searches you have used and when the limit resets.
Messages and errors
| Message | What to do |
|---|---|
| The query is empty… | Describe the legal issue, a section, or a citation. |
| The query is too long… | Shorten it to under 2,000 characters. |
| Invalid year… | Use a 4-digit year between 2000 and the current year, or omit it. |
| Daily search limit reached… | Try again after the reset time shown in the message. |
| Too many searches in a short time… | Wait the number of seconds shown and retry. |
| The search is temporarily unavailable… | A temporary problem on our side or a provider's. Retry in a moment. This did not use your allowance. If it keeps happening, email support@pledr.in and quote the reference code shown in the message so we can find it in our logs. |
Data and privacy
- What we log: the text of your search query, the time, the number of results and how long the search took, together with your account identifier. We use this to run the service, enforce limits and fix problems.
- Who processes it: your query text is sent to our AI infrastructure provider, DeepInfra, to find and rank results. Sign-in is handled by WorkOS. We do not sell personal information.
- What we do not do: the tool does not read your conversation history, your files, or anything other than the query you send.
- Good practice: describe the legal issue rather than naming confidential client details.
Full details, including retention and deletion requests, are in the Privacy Policy and the Terms of Service.
Coverage and limits of accuracy
- Coverage: over 30,000 Supreme Court of India judgments from 2000 to 2026. High Court judgments, tribunals and judgments before 2000 are not included yet. Judgments before 2016 are searchable by their content, but some details, such as neutral citations and summary notes, are not available for them.
- Source: judgments published by the Supreme Court of India. Each result links to the official PDF.
- Accuracy: the quoted paragraph text comes from the judgment. The short case summaries are AI-generated and can be wrong. Always read the source judgment before relying on a result in court or in advice.
- Not legal advice: Pledr is a research tool. It does not give legal advice.
Source of the judgments
The judgments come from the website of the Supreme Court of India (sci.gov.in). Pledr reproduces passages of judgment text with that source acknowledged, and every result includes a link to the official judgment PDF. The court states that the documents on its website are for reference only; always check the official record before relying on a passage in court or in advice. Pledr is independent and is not affiliated with or endorsed by the Supreme Court of India.
Support
Email support@pledr.in with what you searched and what happened. We reply as soon as we can. Security issues can be sent to the same address.