ParaLeagle MCP Connector

The authoritative Claude connector for US immigration practice — USCIS forms, AAO decisions, prevailing wages, SOC codes, education evaluation, and the Visa Bulletin.

Endpoint: https://mcp.paraleagle.ai/mcp/ • OAuth 2.1 + PKCE • Streamable HTTP transport • Production GA: May 17, 2026

On this page: Quick start · Example prompts · Tools · Authentication · Test account · Support

Quick start

The ParaLeagle MCP connector is designed for use by US immigration attorneys, paralegals, and accredited representatives. To add it to Claude:

Open Claude.ai (Pro, Max, Team, or Enterprise plan) and go to Settings → Connectors
Click Add custom connector
Paste the URL https://mcp.paraleagle.ai/mcp/ and click Add
Claude opens an OAuth consent screen hosted at platform.paraleagle.ai/mcp/login. Sign in with your ParaLeagle account and click Allow.
Claude confirms the connection and loads 29 immigration-practice tools.

ParaLeagle's existing access controls apply to all tool calls. Claude can only see and modify cases the authenticated user already has permission to access in the ParaLeagle web app — no escalation surface.

Example prompts

The following prompts demonstrate the connector's value out of the box. After connecting, try them in a new Claude chat:

1. Current Visa Bulletin priority date

What's the EB-2 India final-action priority date for the most recent
Visa Bulletin? Use the connector.

Claude calls get_current_priority_dates and returns the date with source attribution to travel.state.gov.

2. AAO non-precedent decision search

Search AAO decisions about EB-1A extraordinary ability denials, focusing
on cases involving software engineers. Quote the actual decision text in
your answer.

Claude calls search_aao_decisions against a 44,000-decision corpus indexed with Google's text-embedding-001 model and pgvector cosine similarity. Returns 4KB of body text per hit so Claude can quote real legal reasoning, not just headers.

3. SOC-code → prevailing wage chain

Suggest a DOL prevailing wage for a Senior Backend Software Engineer
working in San Francisco County, California, at Level II. Five years
of Python and distributed systems experience.

Claude chains two tools on its own — first determine_soc_code to map the role description to SOC code 15-1252, then suggest_prevailing_wage to look up the DOL Foreign Labor Certification OES data for that SOC in that area. Both responses include source attribution.

4. Education equivalency for H-1B

Evaluate this education for H-1B specialty occupation: Bachelor of
Engineering in Computer Science from Anna University, India, graduated
2018. Is it equivalent to a US bachelor's? The target SOC is 15-1252.

Claude calls evaluate_education and returns a structured verdict (QUALIFIES / FLAG_FOR_ATTORNEY / DOES_NOT_QUALIFY), ordered reasoning steps, and a USCIS-rule trace.

5. USCIS form schema lookup

What fields does USCIS Form I-129 have, grouped by section? Use the
connector — don't list from memory.

Claude calls get_form_field_schema. This is the only programmatic source for USCIS form schemas — there's no public USCIS API.

Tool reference

29 tools across two tiers. Free-tier tools are available to any authenticated ParaLeagle user. Paid-tier tools require a ParaLeagle subscription and are metered per call.

Free tier

get_current_priority_datesFreeRead-only

Most recent Visa Bulletin priority dates by category and country of chargeability. Cached locally per month so we don't re-hit travel.state.gov. Source: Department of State Visa Bulletin.

search_visa_bulletinFreeRead-only

Historical Visa Bulletin movement over the last 1–24 months. Final-action chart only. Use for retrogression/movement-trend analysis.

search_aao_decisionsFreeRead-only

Semantic search over 44,000 USCIS Administrative Appeals Office non-precedent decisions across EB-1A, EB-1B, EB-1C, EB-2, EB-3, H-1B, L-1, O-1. Powered by Gemini embeddings + pgvector. Returns 4KB of decision body text per hit — actual legal reasoning, not just headers.

determine_soc_codeFreeRead-only

Maps a job title and description to a DOL SOC 2018 code for LCA/H-1B/PERM workflows. Returns recommendation with HIGH/MEDIUM/LOW confidence, reasoning, and up to 3 alternatives. Source: DOL SOC 2018 corpus + ParaLeagle SOC classifier.

suggest_prevailing_wageFreeRead-only

DOL prevailing wage level (I/II/III/IV) and dollar amount for a SOC code in a given county. OES-compliant for H-1B/PERM/LCA. Returns the worksheet breakdown for attorney audit. Source: DOL FLC OES data.

evaluate_educationFreeRead-only

Runs the USCIS H-1B specialty-occupation qualification decision tree on a degree + country + SOC + work experience. Returns a verdict and the full rule trace.

list_supported_formsFreeRead-only

Catalog of supported USCIS/DOL forms — G-28, I-129, I-539, I-539A, I-765, G-1450, and the ETA-9035E LCA — with a flag for which forms support standalone fill versus case-bound resolution.

get_form_field_schemaFreeRead-only

USCIS form field schema, grouped by section, for any supported form. The only programmatic source — USCIS has no public form-schema API and forms are revised quarterly.

get_intake_questionnaireFreeRead-only

JSON questionnaire schema for employer H-1B, employee H-1B (and full), H-4 dependent, EAD, or LCA workflows. Use before submit_intake_answers.

fill_form_standaloneFree (5/mo)Destructive

Fill G-28 (attorney appearance) or G-1450 (credit-card authorization) from conversation data, no ParaLeagle case required. Free tier: 5 fills per authenticated user per calendar month. PDF is watermarked DRAFT.

get_filing_addressFreeRead-only

Correct USCIS lockbox / service-center and USPS filing addresses for an H-1B family I-129 filing, by state + premium-processing flag. Source: ParaLeagle's USCIS i-129-addresses snapshot.

get_case_type_enumsFreeRead-only

Every ParaLeagle case-type code with its display label and visa category (H-1B / H-4 / EAD) — the canonical values accepted by the case-bound tools.

get_employer_type_enumsFreeRead-only

Every employer-type code ParaLeagle accepts (LLC, CORPORATION, NON_PROFIT, PARTNERSHIP, SOLO_PROPRIETORSHIP). Validate an employer_type before calling tools that consume it.

get_document_collection_checklistFreeRead-only

Canonical document-collection checklist for a role + case-type combo — the same JSON that drives ParaLeagle's document-upload UI. Fields flagged required / strongly-recommended / recommended.

run_i129_business_rulesFreeRead-only

Applies ParaLeagle's I-129 business rules to a form-data dict (service-center defaults, phone reconciliation, itinerary defaults, and more) and returns the corrected data with a per-field diff.

validate_paystubFreeRead-only

Runs ParaLeagle's paystub compliance checks on extracted paystub fields — recency (default 30 days) and beneficiary-name match. Returns warnings plus pass/fail.

get_billing_statusFreeRead-only

Firm's current subscription tier, included quotas per metered tool, usage so far this period, and any overage charges. Free — never counts against a quota.

Paid tier (subscription)

preview_form_fieldsPaidRead-only

Resolves case data into form field values without generating a PDF. Returns the resolved mapping + a completeness report so Claude can tell the user what's missing before generation.

generate_form_pdfPaidDestructive

Generates a filled USCIS PDF for a case. Returns a 1-hour presigned S3 download URL. DRAFT watermark — sign and file via the ParaLeagle app or USCIS directly.

generate_support_letterPaidDestructive

H-1B or O-1 support letter generated from case intake answers, education evaluation, and role description. Returns DOCX or PDF download URL.

extract_documentPaidDestructive

Multi-provider extraction pipeline (Gemini primary) tuned for paystubs, I-797 approvals, I-94 records, passports, EADs, tax returns, and resumes. Requires the document to already be uploaded via the ParaLeagle web app.

submit_intake_answersPaidDestructive

Writes intake questionnaire answers onto a specific ParaLeagle case. File-upload fields are reported in warnings rather than silently dropped (Claude can't upload files via MCP).

detect_duplicate_casePaidRead-only

Checks whether the firm already has an active case for a given (employer, employee, case-type, year) tuple — the same dedup guard the web app runs before case creation. ACL-scoped to the user's firm.

get_case_timelinePaidRead-only

Ordered milestone timeline for a case (INITIATED → LCA_FILED → PETITION_FILED → APPROVED/DENIED, etc.) from the CaseTimelineEvent table — the single source of truth for stage transitions.

run_compliance_checkPaidRead-only

Pre-filing RFE-risk engine for a case: ML RFE probability, per-topic risk predictions, employer intelligence, OES wage benchmarks, similar-case outcomes, and evidence recommendations.

analyze_rfePaidRead-only

Generates a structured RFE response strategy for a case + RFE topic — response sections, cited AAO authorities with holdings, an evidence list, and editable draft language.

get_sla_reportPaidRead-only

Firm's SLA pipeline dashboard (LCA / filing / overall) — per-case stage, days-in-stage, SLA status, and attorney workload. Firm-scoped; archived cases excluded.

assemble_petition_packetPaidDestructive

Assembles a complete USCIS petition packet in correct filing order (G-28 → I-129 → H-supplement → LCA → support letter → G-1450) into one merged, DRAFT-watermarked PDF. Returns a 1-hour presigned S3 URL.

change_case_typePaidDestructive

Changes a case's type and writes a permanent audit entry (may reconcile related flags). Irreversible except by another change_case_type call.

Authentication

The connector implements OAuth 2.1 with PKCE (S256) and Dynamic Client Registration (RFC 7591). The flow is:

Claude discovers our authorization server via https://mcp.paraleagle.ai/.well-known/oauth-protected-resource
Claude dynamically registers itself as a client via the DCR endpoint
The user is redirected to ParaLeagle's consent screen at https://platform.paraleagle.ai/mcp/login (a Next.js page) where they sign in with their ParaLeagle account (Firebase Authentication) and grant Claude access
The consent screen redirects back to the MCP server's callback, which mints a signed JWT scoped to the authenticated user
Claude stores the encrypted refresh token; future requests automatically refresh access tokens

Both https://claude.ai/api/mcp/auth_callback and https://claude.com/api/mcp/auth_callback are registered redirect URIs.

Reviewer test account

For Anthropic Connectors Directory reviewers, ParaLeagle provides a sandbox account preloaded with fictional sample data. Credentials and case UUIDs are supplied in the submission form and via direct email to the assigned reviewer.

Setup steps for the reviewer:

Open Claude.ai in a fresh session
Add the connector at https://mcp.paraleagle.ai/mcp/
At the consent screen, sign in with the credentials supplied in the submission form
Click Allow to authorize Claude
Run the example prompts in the "Example prompts" section above. The sample case UUID (also supplied in the form) unlocks the paid-tier tools without billing.

Support

General questions: team@paraleagle.ai
Security disclosures (24-hour acknowledgement SLA): team@paraleagle.ai
Privacy and data-rights requests: team@paraleagle.ai
Privacy policy: /privacy

ParaLeagle Inc. — built for US immigration attorneys, paralegals, and accredited representatives.