Lawstronaut

Lawstronaut MCP

Connect lawstronaut to Claude, ChatGPT, Cursor, and any AI agent that speaks the Model Context Protocol. Connect your AI to 50+ million laws and court cases!

Authentication . Setup · Tools

---

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.

Get client ID, secret, or bearer token

1. Visit lawstronaut.com and purchase a subscription.
2. Log in to the developer portal.
3. Open MCP server access from the Home menu.
4. Create a client ID + client secret (OAuth) or a bearer token.

Option A — Bearer token

Use the bearer token from MCP server access:

Authorization: Bearer <your-token>

Set it in your environment:

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.

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.

---

VS Code (GitHub Copilot agent / MCP)

Bearer token

1. Copy vscode-mcp.json to .vscode/mcp.json, or merge into your user MCP config.
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.

---

Claude Code (CLI)

Bearer token — CLI

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:

claude mcp add --transport http lawstronaut-mcp https://mcp.lawstronaut.com

Docs: Connect Claude Code to tools via 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:

---

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
• 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