MCP Connector README — Visalaw AI

Visalaw AI MCP Connector README

Setup, tools, authentication, and data handling for the Claude connector
Last Updated: October 29, 2026 Visalaw Ventures, Inc.

A remote MCP server that gives Claude read-only access to Visalaw AI’s immigration law research tools: the Visalaw AI immigration library, case law search, statute and regulation lookup, and Visalaw AI prompt templates.

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 (S256). See Authentication below.
Access
Read-only. No tool creates, modifies, or deletes data.

Requirements

Adding the connector in Claude

  1. In Claude, go to Customize → Connectors. Find Visalaw AI in the Connectors Directory, or choose Add custom connector and enter https://mcp.visalaw.ai/mcp as the server URL. On Claude Team or Enterprise, an Owner adds it under Organization settings → Connectors.
  2. Click Connect. A Visalaw AI sign-in page opens.
  3. Sign in with your Visalaw AI account. Visalaw AI doesn’t use passwords; sign in with Google or Microsoft 365, or with a verification code sent by email or text. See Getting Started: Logging In.
  4. Approve access. Claude receives a scoped access token (mcp:law-library:read) and the tools below become available in your conversations.

Each connection is tied to one Visalaw AI user and organization. The connector returns only what that user can already access in Visalaw AI.

Tools

Tool What it does
search_immigration_library Semantic search over the Visalaw AI immigration library: USCIS guidance including the USCIS Policy Manual, AILA publications and practice advisories, BIA and AAO decisions, EOIR materials, the INA, the CFR, and Canadian immigration law. Results are ranked by authority, so statutes and USCIS policy come before secondary sources, and cited authorities are checked against the library catalog. Can be limited to one source or category, and can include unpublished BIA decisions.
list_categories Lists the library’s practice-area categories and subcategories, such as employment-based, family-based, and removal defense. Use a category to narrow a library search.
get_document Reads a library document returned by search_immigration_library, up to 10 pages per call. Reads only the shared law library, never a firm’s own uploaded documents.
search_case_law Searches published and unpublished BIA decisions, AAO decisions, unpublished EOIR decisions, and federal court immigration opinions. Recognizes case-name lookups such as “Matter of A-B-” as well as topic searches. Defaults to the BIA and all federal circuits, and can filter by court and filing date. Federal court opinions come from CourtListener.
lookup_statute_regulation Returns the text of a specific INA section or CFR provision by citation, such as “INA 245(i)” or “8 CFR 204.5(h)(3).”
list_prompts Lists prompt templates available to the signed-in user: templates they own, templates shared with them, organization-wide templates, and, on request, Visalaw AI platform templates.
get_prompt Returns the full text of one prompt template so Claude can apply it to the user’s task, such as analyzing an uploaded RFE. A template the user can’t see in Visalaw AI can’t be retrieved.

All seven tools are read-only. None of them modify Visalaw AI data.

Example prompts

Research an immigration question

My client entered on a B-2, married a U.S. citizen, and overstayed by eight months. Can she adjust status without leaving the U.S.? Cite the Policy Manual and any relevant BIA decisions.

Find BIA decisions on a fact pattern

Search published and unpublished BIA decisions from 2023 onward. My client missed her master calendar hearing because she was hospitalized and was ordered removed in absentia. Has the Board found exceptional circumstances in similar cases, and what evidence made the difference?

Look up the text of the law

Pull the text of INA 212(a)(9)(B).

Analyze an RFE with a Visalaw AI template

Upload an RFE to Claude, then ask:

Use the Visalaw AI RFE analysis prompt for O-1 petitions to analyze this RFE, suggest evidence for each item, flag weaknesses in the officer’s reasoning, and draft a response.

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 only) 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 the Bearer token in the Authorization header on every POST /mcp call.

Tokens are scoped to mcp:law-library:read and expire after 90 days. Refresh tokens aren’t issued; when a token expires, the user signs in again. Only registered MCP clients with exact redirect URIs are accepted. If a user’s account is removed or their organization turns the connector off, access ends immediately.

Data handling

For full details, see the MCP Connector Privacy Policy and the general Visalaw AI Privacy Policy.

Disconnecting

To stop using the connector, go to Customize → Connectors in Claude and disconnect Visalaw AI. To have Visalaw AI revoke your access token on its side, contact support@visalaw.ai.

Technical specification and support

The full Visalaw AI MCP Server Specification covers protocol versions, tool arguments and return shapes, error handling, and access controls.

For help with the connector, contact support@visalaw.ai or visit the Visalaw AI Help Center.