Caunsel Legal MCP Server

Technical documentation · Last updated: September 8, 2026 · Protocol version 2025-03-26 · Connector v1.0.0

Read-only legal research connector for Gemini Enterprise. Streamable HTTP.

CAUNSEL IS AN INDEPENDENT SELF-HELP SOFTWARE PLATFORM. IT IS NOT A LAW FIRM AND DOES NOT PRACTISE LAW. MCP OUTPUTS ARE GENERAL LEGAL INFORMATION FOR SELF-PREPARATION, NOT LEGAL ADVICE, AND DO NOT CREATE AN ATTORNEY-CLIENT RELATIONSHIP.

1. Overview

Caunsel Legal is a domain MCP server for cited legal research. It returns jurisdiction-specific answers grounded with Google Search, fact-checks legal claims, and runs a multi-expert panel review. It does not provide licensed legal counsel, lawyer matching, case files, or marketplace access.

Users may use the tools as a self-help aid to research public law and prepare their own matter where the law allows self-representation. Connecting with an independent lawyer in the Caunsel app is optional and is not exposed through this connector.

2. Remote endpoint

Field	Value
MCP Server URL	`https://caunsel-mcp-709835586683.us-central1.run.app/mcp`
Transport	Streamable HTTP (JSON-RPC 2.0 over `POST /mcp`)
Health	`GET /health`
Readiness	`GET /ready`
Protected resource metadata	RFC 9728 `/.well-known/oauth-protected-resource`
Product	https://www.caunsel.com
This documentation	https://www.caunsel.com/mcp

Gemini Enterprise requires Streamable HTTP. This endpoint supports it. Do not use a custom domain for the MCP Server URL in Gemini Enterprise: IAM auto-headers apply to the .run.app URL.

3. Authentication

Identity is Google, not a Caunsel-specific IdP.

Field	Value
Authorization URL	`https://accounts.google.com/o/oauth2/v2/auth`
Token URL	`https://oauth2.googleapis.com/token`
Issuer	`https://accounts.google.com`
Scopes	`openid email`
PKCE	Required
Redirect URI	`https://vertexaisearch.cloud.google.com/oauth-redirect`
Auth URL params	`access_type=offline&prompt=consent`
Cloud Run IAM	Gemini Enterprise sends `X-Serverless-Authorization`. Grant `roles/run.invoker` to `service-<GE_PROJECT_NUMBER>@gcp-sa-discoveryengine.iam.gserviceaccount.com`.

The signed-in Google user must already be a Caunsel customer or lawyer (account created at caunsel.com, role chosen during signup) with an active subscription and enough credits. The Discovery Engine service account may handshake (initialize / tools/list). Tool calls require the human Google token so usage can be billed to that Caunsel user. Service accounts cannot run tools.

4. Available tools

All tools have user-facing titles, semantic descriptions, and MCP safety annotations. None mutate Caunsel data.

ask_legal_question

Title: Ask a legal question

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

Returns a jurisdiction-specific legal answer with citations to statutes, amendments, or court rulings, grounded with Google Search. Use for “what is the law”, rights, notice periods, contract clauses, and similar research. Always pass jurisdiction when known. This is general information, not legal advice. It does not contact a lawyer or open a case.

Argument	Required	Description
`question`	Yes	Legal question to research (max 8,000 characters)
`jurisdiction`	No	Country and optional state/region, e.g. “India, Maharashtra”
`practice_area`	No	e.g. employment, family, contracts, criminal, property, IP
`language`	No	ISO 639-1 code. Default `en`

fact_check_claim

Title: Fact-check a legal claim

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

Verifies a specific legal assertion against current law. Returns FACT, FAKE, or UNCERTAIN with an explanation and source. Use when the user states a rule as fact, not for an open-ended research question.

Argument	Required	Description
`claim`	Yes	Declarative legal assertion to verify
`jurisdiction`	No	Country, state, or legal system
`practice_area`	No	Optional practice area
`language`	No	ISO 639-1 code. Default `en`

run_legal_panel

Title: Run a legal panel review

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

Runs Caunsel’s multi-expert panel: several specialists review the query and return a consensus with cited statutes, risks, and recommendations. Use only for complex, multi-issue, or high-stakes questions. Slower than ask_legal_question. Does not create a case, contact a lawyer, or store the review on a user account.

Argument	Required	Description
`question`	Yes	Legal query for the panel
`jurisdiction`	No	Country or legal system
`practice_area`	No	Optional practice area
`country`	No	Country used to assemble local experts
`state`	No	State or region within the country
`language`	No	ISO 639-1 code. Default `en`

ask_legal_question (Ask a legal question — jurisdiction-specific cited answer, grounded with Google Search. General information only; does not contact a lawyer or open a case.) - readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

fact_check_claim (Fact-check a legal claim — verifies a legal assertion and returns FACT, FAKE, or UNCERTAIN with sources.) - readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

run_legal_panel (Run a legal panel review — multi-expert consensus with cited statutes, risks, and recommendations. Does not create a case or contact a lawyer.) - readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

5. Resources and prompts

caunsel://legal/disclaimer — standard disclaimer that must accompany Caunsel legal information
caunsel://legal/capabilities — JSON list of what this server can and cannot do
Prompt legal_research — draft a grounded research request
Prompt verify_legal_claim — draft a fact-check request

6. What this server does not do

Find, rank, hire, or message a lawyer
Create, list, claim, or manage a case or marketplace matter
Read private case files, vault documents, or employer records
Billing, identity, or account administration
File papers, appear in court, or act as counsel of record

7. Credits and accounts

Tool calls consume the same Caunsel credits as the corresponding in-app features (legalQuery, factChecker, legalPanelReview). New Gemini Enterprise users are not auto-created as Caunsel users. They must complete signup at caunsel.com, choose Customer or Lawyer, subscribe, then retry with the same Google email. Credit or signup errors return an isError tool result pointing at https://caunsel.com.

8. Safety and schema

All tools have titles and detailed semantic descriptions.
All tools are read-only. There are no mutative or write-based tools, so destructiveHint is false on every tool.
openWorldHint: true because answers depend on live search of public legal sources.
Every successful result includes a disclaimer. Clients must surface it and must not present output as legal advice or as a substitute for a licensed lawyer.
If sources are insufficient, the tool says so rather than inventing citations.

Use of the connector is also subject to the Caunsel Terms of Use, Feature Service Agreement, and Privacy Policy, including self-help / self-representation terms and workplace-access terms.

9. Contact

Caunsel
Email: contactus@caunsel.com
Website: www.caunsel.com