Lawstronaut
Connect AI to millions of laws and court cases with the Lawstronaut MCP.
Open source Repository Open in the app JSON README (API)
About
Connect AI to millions of laws and court cases with the Lawstronaut MCP.
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- com.lawstronaut
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.1.1
- Stars
- 1
- Last push
- 2026-07-15T12:03:52Z
- Repository state
- ativo
- License
- NOASSERTION
- Added
- 2026-08-29 03:01:13
- Updated
- 2026-08-29 03:01:13
- Origin id
com.lawstronaut/lawstronaut-mcp
README
<div align="center"> <img src="./assets/lawstronaut-icon.png" width="100" alt="lawstronaut logo" /> # Lawstronaut MCP Connect [lawstronaut](https://mcp.lawstronaut.com) to Claude, ChatGPT, Cursor, and any AI agent that speaks the [Model Context Protocol](https://modelcontextprotocol.io). Connect your AI to 50+ million laws and court cases! [](https://modelcontextprotocol.io) [](#authentication--scopes) [](https://lawstronaut.com/products/lawstronaut-mcp) [](./LICENSE) [Authentication](#Authentication) . [Setup](#setup) · [Tools](#tools) </div> --- ## What is this? Lawstronaut is the infrastructure layer that connects AI agents and software to millions of legal documents across 150+ jurisdictions, structured legal data, continuously updated, and ready to use via MCP. ## Authentication Production MCP server: **`https://mcp.lawstronaut.com`** Transport: **MCP over Streamable HTTP** (`POST /`). Public server card (tool listing, no auth): `https://mcp.lawstronaut.com/.well-known/mcp/server-card.json` --- Lawstronaut MCP supports **Bearer token** and **OAuth 2.0** (`client_id` + `client_secret`). A paid subscription is required. | Method | Best for | Tool listing | Tool calls | |--------|----------|--------------|------------| | Bearer token | CLI, scripts, clients without OAuth | No auth required | `Authorization: Bearer <token>` | | OAuth 2.0 | Cursor, VS Code, Claude, publishing platforms | No auth required | OAuth access token (auto-managed by client) | ### Get client ID, secret, or bearer token 1. Visit [lawstronaut.com](https://lawstronaut.com) and purchase a subscription. 2. Log in to the [developer portal](https://dev-portal.filerskeepersapi.co/). 3. Open **MCP server access** from the Home menu. 4. Create a **client ID** + **client secret** (OAuth) or a **bearer token**. <img src="./assets/generate-client-secret.png" width="800" alt="lawstronaut logo" /> ### Option A — Bearer token Use the bearer token from **MCP server access**: ```http Authorization: Bearer <your-token> ``` Set it in your environment: ```bash export LAWSTRONAUT_MCP_BEARER_TOKEN="your-token-here" ``` Example configs: `cursor-mcp.json`, `vscode-mcp.json`, `claude-code.mcp.json`. ### Option B — OAuth 2.0 (client_id + client_secret) Use the `client_id` and `client_secret` created under **MCP server access** in the [developer portal](https://dev-portal.filerskeepersapi.co/). | Endpoint | URL | |----------|-----| | MCP server | `https://mcp.lawstronaut.com` | | Authorization | `https://mcp.lawstronaut.com/oauth/authorize` | | Token | `https://mcp.lawstronaut.com/oauth/token` | | OAuth discovery | `https://mcp.lawstronaut.com/.well-known/oauth-authorization-server` | | Protected resource | `https://mcp.lawstronaut.com/.well-known/oauth-protected-resource` | **Flow:** `response_type=code` → redirect with `code` → exchange at `/oauth/token` with `grant_type=authorization_code`, `client_id`, `client_secret`, `code`, and `redirect_uri`. Clients that support MCP OAuth discovery only need the server URL — they handle the flow using your registered `client_id` / `client_secret`. Example configs: `cursor-mcp-oauth.json`, `vscode-mcp-oauth.json`. --- ## Setup Pick your client, paste the config, and authenticate with your lawstronaut account. Most clients open a browser window for OAuth the first time an agent uses a lawstronaut tools. ## Cursor **Bearer token** 1. Copy `cursor-mcp.json` to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global). 2. Export `LAWSTRONAUT_MCP_BEARER_TOKEN`. 3. Restart Cursor. Check **Output → MCP Logs** if connection fails. **OAuth** 1. Copy `cursor-mcp-oauth.json` to `.cursor/mcp.json`. 2. Complete the OAuth sign-in when Cursor prompts you (uses your registered `client_id` / `client_secret`). Docs: [Cursor MCP](https://cursor.com/docs/context/mcp). --- ## VS Code (GitHub Copilot agent / MCP) **Bearer token** 1. Copy `vscode-mcp.json` to `.vscode/mcp.json`, or merge into your [user MCP config](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration). 2. Run **MCP: List Servers** and enter your bearer token when prompted. **OAuth** 1. Copy `vscode-mcp-oauth.json` to `.vscode/mcp.json`. 2. Sign in through VS Code when prompted. Docs: [MCP configuration reference](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration). --- ## Claude Code (CLI) **Bearer token — CLI** ```bash export LAWSTRONAUT_MCP_BEARER_TOKEN="your-token-here" claude mcp add --transport http lawstronaut-mcp https://mcp.lawstronaut.com \ --header "Authorization: Bearer $LAWSTRONAUT_MCP_BEARER_TOKEN" ``` **Bearer token — project file** Copy `claude-code.mcp.json` to `.mcp.json` in your project root. **OAuth** Add the server URL only and complete OAuth when prompted: ```bash claude mcp add --transport http lawstronaut-mcp https://mcp.lawstronaut.com ``` Docs: [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp). --- ## Claude Desktop (Anthropic app) Claude Desktop is oriented toward **stdio** MCP servers. For this HTTP server, use **Cursor**, **VS Code**, or **Claude Code**, or any host that supports remote Streamable HTTP MCP. Go to **Customize**, **Connectors**, click "**+**", **Add Custom Connector**, and fill the dialog: <img src="./assets/claude-desktop.png" width="790" alt="claude" /> --- ## Other hosts (Continue, Zed, custom agents, etc.) Any client that supports **MCP Streamable HTTP** can connect with: - **URL:** `https://mcp.lawstronaut.com` - **Bearer:** `Authorization: Bearer <token>` - **OAuth:** use discovery at `/.well-known/oauth-authorization-server` with your `client_id` / `client_secret` --- ## Tools - **list_jurisdictions** - List all jurisdictions (countries/states) in the Lawstronaut corpus — call first to get valid ISO codes for other tools - **list_domains** - List legal domains with optional name filter and pagination - `domain`: Filter domains by name (string, optional) - `limit`: Number of results to return (number, optional) - `offset`: Number of results to skip (number, optional) - **list_subdomains** - List subdomains for a domain ID — filter by name, paginate results - `domain_id`: Filter by Domain ID (string, required) - `subdomain`: Filter subdomains by name (string, optional) - `limit`: Number of results to return (number, optional) - `offset`: Number of results to skip (number, optional) - **list_categories** - List legal categories for a subdomain — filter by name, paginate results - `subdomain_id`: Filter by Subdomain ID (string, optional) - `category_name`: Filter categories by name (string, optional) - `limit`: Number of results to return (number, optional) - `offset`: Number of results to skip (number, optional) - **list_subcategories** - List subcategories for a category ID — filter by name, paginate results - `category_id`: Filter by Category ID (string, required) - `subcategory_name`: Filter subcategories by name (string, optional) - `limit`: Number of results to return (number, optional) - `offset`: Number of results to skip (number, optional) - **list_law_types** - List law types for a subcategory ID — filter by name, paginate results - `subcategory_id`: Filter by Subcategory ID (string, required) - `law_type`: Filter law types by name (string, optional) - `limit`: Number of results to return (number, optional) - `offset`: Number of results to skip (number, optional) - **list_portals** - List legal portals for a jurisdiction — filter by name, language, or tag - `iso`: Filter by Jurisdiction ISO code (e.g. 'US') (string, required) - `name`: Filter portals by name (string, optional) - `tag`: Filter by tag (string, optional) - `lang`: Filter by language (string, optional) - **list_authority_types** - List authority types for a jurisdiction — filter by portal or authority type - `iso`: Filter by Jurisdiction ISO code (e.g. 'US') (string, required) - `limit`: Number of results to return (number, optional) - `offset`: Number of results to skip (number, optional) - `portal_name`: Filter by portal name (string, optional) - `authority_type`: Filter by authority type (string, optional) - **list_issuing_authorities** - List issuing authorities for a jurisdiction — filter by portal or authority name - `iso`: Filter by Jurisdiction ISO code (e.g. 'US') (string, required) - `limit`: Number of results to return (number, optional) - `offset`: Number of results to skip (number, optional) - `portal_name`: Filter by portal name (string, optional) - `issuing_authority`: Filter by issuing authority (string, optional) - **list_documents** - List legal documents in a jurisdiction — filter by title, dates, portal, status, tags, and more - `iso`: Filter by Jurisdiction ISO code (e.g. 'US') (string, required) - `portal`: Filter by portal name (string, optional) - `version`: Document version (string, optional) - `limit`: Number of results to return (number, optional) - `offset`: Number of results to skip (number, optional) - `document_id`: Document ID (string, optional) - `repealed`: Filter by repealed status (boolean, optional) - `title`: Filter by title (string, optional) - `section_title`: Filter by section title (string, optional) - `url`: Filter by URL (string, optional) - `status`: Filter by status (string, optional) - `crawling_date`: Filter by crawling date (string, optional) - `last_updated`: Filter by last updated date (string, optional) - `last_amendment`: Filter by last amendment date (string, optional) - `publication_date`: Filter by publication date (string, optional) - `expiration_date`: Filter by expiration date (string, optional) - `effective_date`: Filter by effective date (string, optional) - `date_of_enactment`: Filter by date of enactment (string, optional) - `date_of_decision`: Filter by date of decision (string, optional) - `file_data_only`: Return only file-related data (boolean, optional) - `issuing_authority`: Filter by issuing authority (string, optional) - `type_of_authority`: Filter by type of authority (string, optional) - `source_identifier`: Filter by source identifier (string, optional) - `source_secondary_identifier`: Filter by secondary source identifier (string, optional) - `tag`: Filter by tag (string, optional) - `lang`: Filter by language (string, optional) - **get_document_text** - Get full text of documents matching jurisdiction and filter criteria - `iso`: Filter by Jurisdiction ISO code (e.g. 'US') (string, required) - `portal`: Filter by portal name (string, optional) - `version`: Document version (string, optional) - `limit`: Number of results to return (number, optional) - `offset`: Number of results to skip (number, optional) - `document_id`: Document ID (string, optional) - `repealed`: Filter by repealed status (boolean, optional) - `title`: Filter by title (string, optional) - `section_title`: Filter by section title (string, optional) - `url`: Filter by URL (string, optional) - `status`: Filter by status (string, optional) - `crawling_date`: Filter by crawling date (string, optional) - `last_updated`: Filter by last updated date (string, optional) - `last_amendment`: Filter by last amendment date (string, optional) - `publication_date`: Filter by publication date (string, optional) - `expiration_date`: Filter by expiration date (string, optional) - `effective_date`: Filter by effective date (string, optional) - `date_of_enactment`: Filter by date of enactment (string, optional) - `date_of_decision`: Filter by date of decision (string, optional) - `file_data_only`: Return only file-related data (boolean, optional) - `issuing_authority`: Filter by issuing authority (string, optional) - `type_of_authority`: Filter by type of authority (string, optional) - `source_identifier`: Filter by source identifier (string, optional) - `source_secondary_identifier`: Filter by secondary source identifier (string, optional) - `tag`: Filter by tag (string, optional) - `lang`: Filter by language (string, optional) - **get_markdown** - Get document body as markdown for matching jurisdiction and filters - `iso`: Filter by Jurisdiction ISO code (e.g. 'US') (string, required) - `portal`: Filter by portal name (string, optional) - `version`: Document version (string, optional) - `limit`: Number of results to return (number, optional) - `offset`: Number of results to skip (number, optional) - `document_id`: Document ID (string, optional) - `repealed`: Filter by repealed status (boolean, optional) - `title`: Filter by title (string, optional) - `section_title`: Filter by section title (string, optional) - `url`: Filter by URL (string, optional) - `status`: Filter by status (string, optional) - `crawling_date`: Filter by crawling date (string, optional) - `last_updated`: Filter by last updated date (string, optional) - `last_amendment`: Filter by last amendment date (string, optional) - `publication_date`: Filter by publication date (string, optional) - `expiration_date`: Filter by expiration date (string, optional) - `effective_date`: Filter by effective date (string, optional) - `date_of_enactment`: Filter by date of enactment (string, optional) - `date_of_decision`: Filter by date of decision (string, optional) - `file_data_only`: Return only file-related data (boolean, optional) - `issuing_authority`: Filter by issuing authority (string, optional) - `type_of_authority`: Filter by type of authority (string, optional) - `source_identifier`: Filter by source identifier (string, optional) - `source_secondary_identifier`: Filter by secondary source identifier (string, optional) - `tag`: Filter by tag (string, optional) - `lang`: Filter by language (string, optional) - **get_source_url** - Get a time-limited signed URL to the original source file (PDF, etc.) - `document_id`: Document ID (integer, required) - **get_document_with_version** - Get a specific document at a specific version with full metadata - `document_id`: Document ID (integer, required) - `version`: Version (integer, required) - **horizon_scan** - Scan recent legal changes in a jurisdiction — filter by topic, date window, and authority - `iso`: One ISO code e.g. "IE", "NL", "US", etc (string, required) - `since`: Start of date window for the scan (string, optional) - `topic`: Topic or keyword to focus the scan (string, optional) - `date_field`: Which date field to use for the window (string, optional) - `status`: Filter by status (string, optional) - `issuing_authority`: Filter by issuing authority (string, optional) - `type_of_authority`: Filter by type of authority (string, optional) - `include_repealed`: Include repealed documents (boolean, optional) - `max_per_jurisdiction`: Maximum results per jurisdiction (integer, optional) - **evidence_pull** - Get full citation chain for a document — metadata, legal link, source URL, and body text - `iso`: Document's jurisdiction ISO code, e.g. 'IE', 'NL', 'US', etc (string, required) - `document_id`: Numeric document_id from any listing/search tool (integer, required) - `include_text`: Include document body text (boolean, optional) - `include_source_url`: Include signed source URL (boolean, optional) - `text_format`: Format for included text (e.g. markdown or plain) (string, optional) All tools are read-only. OAuth tokens are issued with scope `mcp:tools:read`. Tool listing is public; tool calls require authentication. ---