rodcar/uk-licensed-sponsors-mcp

📋 Table of Contents

• 🎯 Overview
• 🎬 Demo
• 🔧 Tools
• 💬 Prompts
• 🚀 How to Use
• 💡 Examples
• 🏛️ Architecture Diagram
• 📝 License

🎯 Overview

UK Licensed Sponsors MCP is a Model Context Protocol (MCP) server that provides verification and background checking for companies on the UK's official Register of Worker and Temporary Worker licensed sponsors (including sponsors for the Skilled Worker visa). This server enables AI agents and applications to verify if companies are licensed to sponsor individuals and perform comprehensive company research through a standardized MCP interface. This helps international students, job seekers, and immigration professionals to assess potential employers and their sponsorship status.

🎬 Demo

🔧 Tools

Note: It's possible that a search may not find a company on the results, even if it is on the official register. The search_in_sponsors_register tool uses fuzzy string matching and may return multiple potential matches, with the results limited to the top 10. It is up to the agent or LLM to select the correct company from the results.

💬 Prompts

🚀 How to Use

Claude Desktop (Remote Server)

Note: Requires npx which comes bundled with npm. If you don't have npm installed, install Node.js which includes npm.

Add to Claude Desktop config (Claude > Settings > Developer > Edit Config):

{
  "mcpServers": {
    "uk_licensed_sponsors": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://uk-licensed-sponsors-mcp.onrender.com/mcp"
      ]
    }
  }
}

Local Server

Note: A Companies House API key is required for full functionality. Get your free API key from Companies House Developer Hub. The sponsor register search works without an API key.

Important: When setting up your Companies House API key, you need to configure http://my.localdomain as a "JavaScript domain", and set up localhost domain mapping for your actual IP address to http://my.localdomain. See our for detailed steps on how to configure your hosts file.

Note: Make sure you have uv installed. If not, install it from uv.tool.

Clone and install:

git clone https://github.com/rodcar/uk-licensed-sponsors-mcp.git
cd uk-licensed-sponsors-mcp
uv sync

Set up environment variables (optional - required for Companies House integration):

echo "COMPANIES_HOUSE_API_KEY=your_api_key_here" > .env

Add to Claude Desktop config (Claude > Settings > Developer > Edit Config):

Note: Replace /path/to/uk-licensed-sponsors-mcp with the actual path where you cloned the repository.

{
  "mcpServers": {
    "uk_licensed_sponsors": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/uk-licensed-sponsors-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

MCP Inspector (Alternative)

Note: A Companies House API key is required for full functionality. Get your free API key from Companies House Developer Hub. The sponsor register search works without an API key.

Important: When setting up your Companies House API key, you need to configure http://my.localdomain as a "JavaScript domain", and set up localhost domain mapping for your actual IP address to http://my.localdomain. See our for detailed steps on how to configure your hosts file.

Note: Requires npx which comes bundled with npm. If you don't have npm installed, install Node.js which includes npm.

Note: Replace /path/to/uk-licensed-sponsors-mcp with the actual path where you cloned the repository.

Run:

npx @modelcontextprotocol/inspector \
  uv \
  --directory /path/to/uk-licensed-sponsors-mcp \                     
  run \
  main.py

Open MCP Inspector (URL displayed in the console) and configure the MCP client with the following settings:

• Transport Type: STDIO
• Command: python
• Arguments: main.py

💡 Examples

Note: The companies for the examples were selected at random.

🏛️ Architecture Diagram

UK Licensed Sponsors MCP follows the Model Context Protocol specification and provides access to the UK's Register of Licensed Sponsors and Companies House data for visa sponsorship verification.

graph LR
    CLIENT[MCP Client<br/>Claude Desktop, IDE, etc.] --> MCP_SERVER[UK Licensed Sponsors MCP Server]
    
    subgraph TOOLS ["🔧 Tools"]
        SEARCH_REGISTER[search_in_sponsors_register]
        GET_DETAILS[get_company_from_sponsors_register]
        SEARCH_CH[search_in_companies_house]
        GET_PROFILE[get_company_profile_from_companies_house]
        GET_OFFICERS[get_company_officers_from_companies_house]
    end
    
    subgraph "💬 Prompts"
        CHECK_SPONSOR[is_company_licensed_sponsor]
        FULL_PROFILE[get_company_full_profile]
    end
    
    MCP_SERVER --> SEARCH_REGISTER
    MCP_SERVER --> GET_DETAILS
    MCP_SERVER --> SEARCH_CH
    MCP_SERVER --> GET_PROFILE
    MCP_SERVER --> GET_OFFICERS
    MCP_SERVER --> CHECK_SPONSOR
    MCP_SERVER --> FULL_PROFILE
    
    SEARCH_REGISTER --> CACHE[Cache Layer]
    GET_DETAILS --> CACHE
    CACHE --> UK_REGISTER[UK Register of Licensed Sponsors]
    SEARCH_CH --> COMPANIES_HOUSE[Companies House API]
    GET_PROFILE --> COMPANIES_HOUSE
    GET_OFFICERS --> COMPANIES_HOUSE
    
    style CLIENT fill:#e3f2fd
    style MCP_SERVER fill:#f3e5f5
    style UK_REGISTER fill:#fff3e0
    style COMPANIES_HOUSE fill:#fff3e0

📝 License

This project is licensed under the .