MCP Connector README — Visalaw AI

Visalaw.ai MCP Connector README

Setup, Tools, and Authentication for the Claude Connector
Last Updated: September 17, 2026 Visalaw Ventures, INC

A remote MCP server that gives Claude read-only access to Visalaw.ai's immigration law research tools and prompt library.

Server URL
https://mcp.visalaw.ai/mcp
Transport
Streamable HTTP (JSON-RPC 2.0 over a single POST /mcp)
Auth
OAuth 2.1 with PKCE. See Authentication below.

Adding the connector in Claude

  1. In Claude, add a custom connector (or find "Visalaw.ai" in the Connectors Directory once published) and enter https://mcp.visalaw.ai/mcp as the server URL.
  2. You'll be redirected to sign in with your Visalaw.ai account.
  3. After sign-in, Claude receives a scoped access token (mcp:law-library:read) and the tools below become available in your conversation.

Every connection is tied to a Visalaw.ai user and organization — the connector only returns data the signed-in user's org already has access to in the app.

Tools

Tool What it does
list_categories Lists the top-level categories/subcategories in the immigration law library. Call this first if you want to scope a search to one category.
search_immigration_library Semantic search over the immigration law library (USCIS guidance, BIA/AAO decisions, INA, CFR, EOIR materials, practice advisories). Results are authority-ranked and cited authorities are checked against the library catalog. Omit categoryId to search the whole library.
lookup_statute_regulation Direct lookup of a specific INA section or CFR provision by citation (e.g. "INA 245(i)"), bypassing semantic search.
search_case_law Searches BIA decisions, AAO decisions, and federal court immigration opinions via CourtListener. Defaults to BIA + all federal circuits; state courts excluded unless explicitly requested.
get_document Fetches the full text of a library document by the documentId returned from search_immigration_library.
list_prompts Lists prompts saved in the signed-in user's organization prompt library (name, description, mode, tags).
get_prompt Retrieves the full content of a specific saved prompt by ID, for use as a system instruction.

All seven tools are read-only — none of them modify Visalaw.ai data.

Authentication

The server implements the OAuth 2.1 discovery flow described in the MCP authorization spec:

  1. Claude calls GET /.well-known/oauth-protected-resource/mcp to learn the authorization server.
  2. Claude calls GET /.well-known/oauth-authorization-server to discover the /oauth/authorize and /oauth/token endpoints.
  3. The user is redirected to /oauth/authorize (PKCE, S256) and signs in with their Visalaw.ai account.
  4. Claude exchanges the resulting authorization code for a Bearer access token at /oauth/token.
  5. Claude sends that Bearer token on every POST /mcp call. Tokens are scoped to mcp:law-library:read and expire after 90 days.

Support

Issues with the connector: support@visalaw.ai.

For how the connector handles data, see the MCP Connector Privacy Policy.