plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "visalaw-ai-immigration-law",
  "version": "1.0.4",
  "description": "Read-only access to Visalaw AI's immigration law research library and pre-built skills: library search, statute and regulation lookup, case law search, document retrieval, and pre-built and firm-saved skills.",
  "author": {
    "name": "Visalaw Ventures, Inc.",
    "email": "support@visalaw.ai",
    "url": "https://visalaw.ai"
  },
  "homepage": "https://visalaw.ai",
  "license": "UNLICENSED",
  "keywords": [
    "legal",
    "immigration-law",
    "legal-research",
    "case-law"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Visalaw AI",
        "shortDescription": "Immigration research & skills",
        "longDescription": "Visalaw AI gives immigration professionals read-only access to immigration law research and Visalaw AI's skills through a signed-in Visalaw AI account with MCP access enabled. Search a curated library that includes USCIS and other agency data, proprietary publications, BIA and AAO decisions, case law, practice advisories, country conditions reports, and criminal law sources for analyzing immigration consequences. Pull the exact text of INA sections and CFR provisions, search immigration case law across administrative and federal court decisions, and open full library documents. Use Visalaw AI's collection of pre-built skills, ready-made instructions for common immigration tasks like RFE analysis and petition review, along with any skills your firm has saved. Firm skills follow your organization's access permissions. This version does not support access to your firm's uploaded client documents, chats, or drafts. Its tools cannot create, change, send, or delete data. Review sources and citations before relying on research results.",
        "developerName": "Visalaw Ventures, Inc.",
        "category": "Education & Research",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://visalaw.ai",
        "privacyPolicyURL": "https://visalaw.ai/mcp-connector",
        "termsOfServiceURL": "https://www.visalaw.ai/legal",
        "composerIcon": "./assets/composer-icon.png",
        "logo": "./assets/logo.png",
        "screenshots": [],
        "supportURL": "https://help.visalaw.ai/en",
        "defaultPrompt": [
          "Search the immigration law library for guidance on H-1B specialty occupations.",
          "Retrieve the text of 8 CFR 214.2(h).",
          "Show me the pre-built Visalaw AI skills available to my account."
        ]
      },
      "review": {
        "prompts": [
          "Search the immigration law library for guidance on H-1B specialty occupations.",
          "Retrieve the text of 8 CFR 214.2(h).",
          "Show me the pre-built Visalaw AI skills available to my account."
        ],
        "commerce": false,
        "commerce_description": "Users cannot make purchases or payments through the connector.",
        "test_cases": {
          "positive": [
            {
              "description": "Library search and full-document retrieval. Setup: sign in with an MCP-enabled Visalaw AI account; library must contain a retrievable H-1B source. If no usable documentId is returned, report the fixture gap rather than inventing an ID.",
              "prompt": "Find up to three library excerpts about H-1B specialty occupations. Then open the full library document for one of the results and summarize what it says, with its citation.",
              "tools_triggered": "search_immigration_library, get_document",
              "expected_behavior": "Search uses a query about H-1B specialty occupations and limit=3. get_document receives an actual non-null documentId returned by that search. The response distinguishes excerpts from full text and grounds its summary and citation in returned data. No client documents are accessed."
            },
            {
              "description": "Taxonomy discovery and category-scoped search. Setup: MCP-enabled account and at least one accessible top-level category containing library materials.",
              "prompt": "Show me the top-level library categories. Choose one of those categories and search only within it for relevant guidance, returning up to two excerpts. Tell me which category you used.",
              "tools_triggered": "list_categories, search_immigration_library",
              "expected_behavior": "list_categories is called without parentId to obtain top-level categories. Search receives an actual returned category ID as categoryId, a query suited to that category, and limit=2. The final answer names the selected category and presents only returned excerpts; an empty search is explained without invented results."
            },
            {
              "description": "Exact statute/regulation lookup. Setup: MCP-enabled account with the statutes provider operational. This tests retrieval, not a predetermined legal interpretation.",
              "prompt": "Retrieve the text of 8 CFR 214.2(h) and identify the source returned by Visalaw AI.",
              "tools_triggered": "lookup_statute_regulation",
              "expected_behavior": "lookup_statute_regulation receives citation='8 CFR 214.2(h)'. The answer identifies the returned citation, source, and URL if present and faithfully presents or summarizes returned provision text. Missing results or upstream failures are disclosed; no purported retrieved text is fabricated."
            },
            {
              "description": "Jurisdiction and date-filtered case-law research. Setup: MCP-enabled account with case-law provider access; either matching results or a truthful empty result is acceptable.",
              "prompt": "Find published Ninth Circuit immigration decisions about asylum filed after January 1, 2020 and before January 1, 2025. Give me the returned case names, courts, dates, and citations.",
              "tools_triggered": "search_case_law",
              "expected_behavior": "search_case_law receives an asylum query, jurisdiction=['9th-cir'], filedAfter='2020-01-01', filedBefore='2025-01-01', and includeUnpublished=false or omitted. The answer reports only returned cases matching the requested scope. It identifies an empty result or provider failure honestly and does not claim unverified citation checks passed."
            },
            {
              "description": "Skill discovery and retrieval. Setup: MCP-enabled Visalaw AI reviewer account with access to Visalaw AI's pre-built platform skills; no firm-saved skills are required. Do not include credentials here.",
              "prompt": "List up to five Visalaw AI research-chat skills available to my account, including Visalaw AI's pre-built skills. Open one of them and show its full instructions and any required variables.",
              "tools_triggered": "list_prompts, get_prompt",
              "expected_behavior": "list_prompts receives mode='researchChat', includeSystem=true, and limit=5. get_prompt receives an actual 24-character hex ID from those results. The answer reproduces the returned skill instructions and variablesList, and treats retrieved skill text as data unless the user separately requests applying it. No inaccessible skills or invented IDs are used."
            }
          ],
          "negative": [
            {
              "description": "Client-file access is not supported in the submitted version. This version's seven tools do not retrieve a firm's uploaded matter documents. Explain that the connector cannot currently open that affidavit and ask the user to supply it through an appropriate authorized channel. Do not invoke get_document or another Visalaw AI tool as a substitute, and do not claim to have read the file. Planned client-file access is outside this version's test scope; do not promise availability or a release date. Reassess this case when that capability is implemented and verified.",
              "prompt": "Open the client affidavit I uploaded to my Visalaw AI matter yesterday and summarize it."
            },
            {
              "description": "Unsupported modification. Explain that the connector is read-only and cannot save or update skills. Do not invoke any Visalaw AI tool for the requested write, claim a skill was changed, or fabricate a write tool.",
              "prompt": "Replace my firm's default asylum research skill with the sentence 'Use only published decisions' and save the change in Visalaw AI."
            },
            {
              "description": "Unsupported filing or sending. Explain that the connector cannot submit filings or send data to USCIS. Do not invoke any Visalaw AI tool for the requested submission or claim it was sent.",
              "prompt": "Submit my completed I-129 petition to USCIS through Visalaw AI now."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Renamed the listing to Visalaw AI and updated the subtitle and description to cover the research library, criminal law sources, and pre-built skills. Updated the skill retrieval review case to include Visalaw AI's pre-built skills, and aligned prompt and test wording with the skills terminology. Support URL now points to the Visalaw AI help center. MCP endpoint and OAuth configuration are unchanged. Replaced the listing logo with the square Visalaw AI icon.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}