LookC Logo

Available Tools

The LookC MCP server provides seven powerful tools for employee research, organization mapping, company search, and employment watch management. Each tool is designed to handle specific use cases while maintaining consistent parameter patterns and response formats.

Overview

All tools in the LookC MCP server follow consistent design patterns:

  • Standardized Parameters: Common filtering options across employee research tools
  • Pagination Support: Cursor-based pagination for handling large datasets
  • Error Handling: Consistent error responses with detailed context
  • Real-time Data: Direct access to current LookC database information

Employee Research

Retrieve and filter employee lists with advanced search capabilities.

Organization Mapping

Convert LinkedIn URLs to LookC organization identifiers seamlessly.

Company Search

Search and discover organizations with advanced filtering capabilities.

Employment Watch Management

Create and manage employment watches to monitor organizational changes.

get_employee_list

Retrieve a comprehensive list of employees for a specific organization with advanced filtering capabilities.

Parameters

  • Name
    orgId
    Type
    string
    Description

    The LookC organization UUID identifier. This is the primary key for organization lookup.

  • Name
    title_regexp
    Type
    string
    Description

    Regular expression pattern to filter employees by job title. Case-insensitive matching.

  • Name
    location_regexp
    Type
    string
    Description

    Regular expression pattern to filter employees by location. Matches city, state, or country.

  • Name
    seniority_levels
    Type
    array
    Description

    Array of seniority levels. OpenAPI spec uses integers: 0 (partner_cxo), 1 (vp_director), 2 (manager), 3 (lower). MCP uses enum names: partner_cxo, vp_director, manager, lower.

  • Name
    page_size
    Type
    integer
    Description

    Maximum number of employees to return. Default: 50, Maximum: 500.

  • Name
    after
    Type
    string
    Description

    Pagination cursor for retrieving subsequent pages of results.

Response

Returns a paginated list of employee profiles with the following structure:

  • Name
    employees
    Type
    array
    Description

    Array of employee objects containing profile information.

    • Name
      id
      Type
      string
      Description

      Unique employee identifier in LookC system.

    • Name
      name
      Type
      string
      Description

      Full name of the employee.

    • Name
      title
      Type
      string
      Description

      Current job title or position.

    • Name
      location
      Type
      string
      Description

      Geographic location (city, state, country).

    • Name
      seniority_level
      Type
      string
      Description

      Categorized seniority level: PARTNER_CXO, VP_DIRECTOR, MANAGER, or LOWER.

    • Name
      linkedin_url
      Type
      string
      Description

      LinkedIn profile URL if available.

  • Name
    paging
    Type
    object
    Description

    Pagination metadata using OpenAPI Paging schema.

    • Name
      total
      Type
      integer
      Description

      Total number of employees available.

    • Name
      count
      Type
      integer
      Description

      Number of employees in current response.

    • Name
      _links
      Type
      object
      Description

      Pagination links.

      • Name
        next
        Type
        string
        Description

        URL for next page of results.

      • Name
        prev
        Type
        string
        Description

        URL for previous page of results.

Example Usage

Employee list retrieval

{
  "tool": "get_employee_list",
  "arguments": {
    "orgId": "550e8400-e29b-41d4-a716-446655440000",
    "title_regexp": "engineer|developer",
    "seniority_levels": [1, 2],
    "page_size": 100
  }
}

get_employee_list_by_linkedin

Retrieve employee lists using LinkedIn company URLs, automatically resolving to LookC organization data. This is a convenience wrapper that accepts LinkedIn URLs for organization identification and uses the same parameters as get_employee_list.

Parameters

  • Name
    li_profile_link
    Type
    string
    Description

    The LinkedIn company profile URL (e.g., "https://www.linkedin.com/company/example").

  • Name
    li_sales_nav_link
    Type
    string
    Description

    The LinkedIn Sales Navigator company URL (alternative to li_profile_link).

  • Name
    title_regexp
    Type
    string
    Description

    Regular expression pattern to filter employees by job title.

  • Name
    location_regexp
    Type
    string
    Description

    Regular expression pattern to filter employees by location.

  • Name
    seniority_levels
    Type
    array
    Description

    Array of seniority levels. OpenAPI spec uses integers: 0 (partner_cxo), 1 (vp_director), 2 (manager), 3 (lower). MCP uses enum names: partner_cxo, vp_director, manager, lower.

  • Name
    page_size
    Type
    integer
    Description

    Maximum number of employees to return. Default: 50, Maximum: 500.

  • Name
    after
    Type
    string
    Description

    Pagination cursor for retrieving subsequent pages.

Response

Identical structure to get_employee_list, with automatic LinkedIn URL resolution.

Example Usage

LinkedIn-based employee search

{
  "tool": "get_employee_list_by_linkedin",
  "arguments": {
    "li_profile_link": "https://www.linkedin.com/company/openai",
    "title_regexp": "research|scientist",
    "seniority_levels": [0, 1]
  }
}

get_organization_ids

Convert LinkedIn company URLs or Sales Navigator URLs to LookC organization identifiers for use with other tools.

Parameters

  • Name
    linkedin_url
    Type
    string
    Description

    Standard LinkedIn company page URL.

  • Name
    sales_nav_url
    Type
    string
    Description

    LinkedIn Sales Navigator company URL.

  • Name
    lookc_id
    Type
    string
    Description

    Existing LookC organization identifier for validation.

Parameter Requirements: Provide exactly one of linkedin_url, sales_nav_url, or lookc_id. Multiple parameters will result in an error.

Response

  • Name
    orgId
    Type
    string
    Description

    Primary LookC organization UUID identifier.

  • Name
    name
    Type
    string
    Description

    Official organization name in LookC database.

  • Name
    liId
    Type
    string
    Description

    LinkedIn internal company identifier.

  • Name
    salesNavId
    Type
    string
    Description

    Sales Navigator company identifier.

  • Name
    links
    Type
    object
    Description

    Related URLs and identifiers for the organization.

Example Usage

Organization ID resolution

{
  "tool": "get_organization_ids",
  "arguments": {
    "linkedin_url": "https://www.linkedin.com/company/stripe"
  }
}

Search for companies/organizations based on query and filters.

Parameters

  • Name
    query
    Type
    string
    Description

    Search query string for organization names.

  • Name
    filters
    Type
    array
    Description

    Array of CompanySearchFilter objects with filter_type and values.

  • Name
    sort
    Type
    object
    Description

    Sort options with field and direction (ASC/DESC).

  • Name
    pageSize
    Type
    integer
    Description

    Number of results per page.

  • Name
    paginationToken
    Type
    string
    Description

    Token for pagination.

  • Name
    after
    Type
    string
    Description

    Cursor for pagination.

Response

  • Name
    organisations
    Type
    array
    Description

    Array of organization search results.

    • Name
      org
      Type
      object
      Description

      Organization IDs and basic information.

    • Name
      profile
      Type
      object
      Description

      Detailed organization profile information.

  • Name
    paging
    Type
    object
    Description

    Pagination metadata using OpenAPI Paging schema.

Example

{
  "query": "technology startup",
  "filters": [
    {
      "filter_type": "COMPANIES_HOUSE_NUMBER",
      "values": ["12345678"]
    }
  ],
  "sort": {
    "field": "name",
    "direction": "ASC"
  },
  "pageSize": 20
}

create_employment_watch

Create a new employment watch for an organization to monitor employee changes.

Parameters

  • Name
    orgId
    Type
    string
    Description

    Organization UUID identifier.

  • Name
    locationFilter
    Type
    string
    Description

    Filter for employee location/country.

  • Name
    titleFilter
    Type
    string
    Description

    Filter for job titles.

  • Name
    seniorityLevels
    Type
    array
    Description

    Array of seniority levels (0-3).

  • Name
    priority
    Type
    integer
    Description

    Priority for processing queue. Higher numbers = higher priority.

Response

  • Name
    watch
    Type
    object
    Description

    The created employment watch.

    • Name
      watchId
      Type
      string
      Description

      Unique identifier for the watch.

    • Name
      orgId
      Type
      string
      Description

      Organization UUID.

    • Name
      status
      Type
      string
      Description

      Watch status (NO_STATUS, READY).

    • Name
      creditCost
      Type
      integer
      Description

      Credits consumed by this watch.

  • Name
    creditsDeducted
    Type
    number
    Description

    Number of credits deducted from account.

Example

{
  "orgId": "550e8400-e29b-41d4-a716-446655440000",
  "locationFilter": "United States",
  "titleFilter": "engineer|developer",
  "seniorityLevels": [1, 2],
  "priority": 5
}

get_employment_watches

Retrieve all employment watches for a team with pagination and filtering options.

Parameters

  • Name
    pageSize
    Type
    integer
    Description

    Number of watches per page.

  • Name
    after
    Type
    string
    Description

    Cursor for next page.

  • Name
    before
    Type
    string
    Description

    Cursor for previous page.

  • Name
    sortBy
    Type
    string
    Description

    Sort field and direction (e.g., lastCollectedAt:DESC, priority:DESC).

  • Name
    lastCollectedAfter
    Type
    string
    Description

    Filter watches collected after this date (YYYY-MM-DD).

Response

  • Name
    watches
    Type
    array
    Description

    Array of employment watches.

  • Name
    paging
    Type
    object
    Description

    Pagination metadata using OpenAPI Paging schema.

Example

{
  "pageSize": 10,
  "sortBy": "lastCollectedAt:DESC",
  "lastCollectedAfter": "2024-01-01"
}

bulk_update_employment_watches

Update multiple employment watches in a single operation. This is an MCP-specific convenience function that wraps multiple update calls.

Parameters

  • Name
    updates
    Type
    array
    Description

    Array of watch update objects.

    • Name
      watchId
      Type
      string
      Description

      ID of the watch to update.

    • Name
      locationFilter
      Type
      string
      Description

      Updated location filter.

    • Name
      titleFilter
      Type
      string
      Description

      Updated title filter.

    • Name
      seniorityLevels
      Type
      array
      Description

      Updated seniority levels.

    • Name
      priority
      Type
      integer
      Description

      Updated priority.

Response

  • Name
    updated_watches
    Type
    array
    Description

    Array of successfully updated watches.

  • Name
    failed_updates
    Type
    array
    Description

    Array of failed update attempts with error details.

Example

{
  "updates": [
    {
      "watchId": "watch-123-456-789",
      "titleFilter": "senior engineer|lead developer",
      "priority": 8
    },
    {
      "watchId": "watch-987-654-321",
      "locationFilter": "Canada",
      "seniorityLevels": [0, 1]
    }
  ]
}

Error Handling

All tools return consistent error responses for common scenarios:

  • Name
    error
    Type
    object
    Description

    Error information with context and resolution guidance.

    • Name
      code
      Type
      string
      Description

      Error code: INVALID_TOKEN, ORG_NOT_FOUND, RATE_LIMITED, INVALID_PARAMS.

    • Name
      message
      Type
      string
      Description

      Human-readable error description.

    • Name
      details
      Type
      object
      Description

      Additional context specific to the error type.

For detailed debugging information, see the Debugging guide.

Was this page helpful?