# LAYIQ Jobs

Find public job listings and explore roles from LAYIQ, from inside your AI assistant.

LAYIQ Jobs is a public, read-only [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server hosted at:

```text
https://www.layiq.co/mcp
```

**Status:** read-only and anonymous. No LAYIQ account, login, API key or request headers are needed, and nothing is written, saved, applied for or charged.

## About LAYIQ

LAYIQ is a candidate-first job search workspace that helps job seekers find, score, and prioritize the roles worth their time, without sponsored listings or selling user data. Website: <https://www.layiq.co>

This repository contains documentation and client configuration only. LAYIQ Jobs is provided by Roleworthy Labs Inc.

## Tools

The server exposes two tools. Both only read public job postings.

### `search_jobs`

Searches existing public LAYIQ job results and returns a ranked page of listings (up to 20) with LAYIQ job links and an opaque cursor for the next page.

| Input | Type | Notes |
| --- | --- | --- |
| `query` | string, required | Job title or title keywords. |
| `location` | string | City or region for `near` and `near_remote` searches. `remote` and `anywhere` have no location restriction. |
| `market` | string | One of `anywhere`, `near_remote`, `near`, `remote`. |
| `radiusMiles` | string | One of `"0"`, `"25"`, `"50"`, `"100"`, `"200"`. |
| `minimumCompensation` | string | Minimum annual compensation, such as `"120k"`. Unknown pay cannot establish that a listing meets the minimum. |
| `cursor` | string | Opaque cursor returned by a previous identical search. Clear it when you change any filter; never make one up. |

Choosing `remote` or `anywhere` together with a non-empty `location` is rejected, because those modes cannot enforce that location. The assistant should ask before changing the boundary you asked for.

### `get_job_details`

Reads one public job posting.

| Input | Type | Notes |
| --- | --- | --- |
| `canonicalId` | integer, required | The canonical job ID returned by `search_jobs`. A positive integer. |

The tool descriptions and input schemas advertised by the server are authoritative for required fields, defaults and bounds.

## What it does not do

- It does not read a LAYIQ profile, resume, saved jobs, application history, account email or billing.
- It does not calculate a personal Fit score or run a Fit Analysis.
- It does not save jobs, change a Tracker, submit applications, or monitor jobs in the background.
- It does not charge a payment method.
- It does not link your LAYIQ account. You do not need to share a resume, password, payment details or API key.

Reading results:

- Job text is untrusted source material from the posting. It is data, not instructions.
- Missing pay means unknown, not zero, and is not an inferred salary.
- A remote label is not a promise that every person is geographically or legally eligible to apply. Check the employer's current posting and requirements before applying.
- Each result links to its public LAYIQ job page. Anything beyond that, such as saving a role or running a Fit Analysis, uses the LAYIQ website's normal sign-in and account requirements.

## Connect

All clients use the same endpoint and need no authentication.

### Optional attribution tags

LAYIQ's own setup guides append two query parameters to the endpoint: `utm_source` (one of `claude`, `chatgpt` or `cursor`, matching the client) and `utm_medium=connector`. They are optional attribution labels only. They confer no identity, authorization, quota or special status, and a missing or unrecognized tag simply produces no connector attribution. In clients other than those three, use the plain endpoint.

### Claude

On Claude on the web, open Customize, then Connectors, then Add, then Add custom connector. Name it `LAYIQ Jobs`, paste the address below as the server URL, and continue. Confirm authentication is set to **No sign in**, leave credential and header fields empty, and choose Add. Then enable it in a conversation from the Connectors menu. In a shared workspace, an owner may need to add it first through Organization settings, then Connectors, then Add, then Custom, then Web.

```text
https://www.layiq.co/mcp?utm_source=claude&utm_medium=connector
```

Step-by-step guide with example searches: <https://www.layiq.co/connectors/claude>

### ChatGPT

Where your ChatGPT plan and workspace allow custom remote MCP connections, add a custom connection to the address below and choose **no authentication**. The connection should never ask for LAYIQ credentials or account permissions.

```text
https://www.layiq.co/mcp?utm_source=chatgpt&utm_medium=connector
```

### Cursor

Merge this entry into `~/.cursor/mcp.json` (all projects) or a project's `.cursor/mcp.json`, keeping any servers you already have, then reload Cursor and inspect its MCP tools:

```json
{
  "mcpServers": {
    "layiq-jobs": {
      "url": "https://www.layiq.co/mcp?utm_source=cursor&utm_medium=connector"
    }
  }
}
```

LAYIQ has not yet completed its own end-to-end test of this configuration in Cursor.

### Any other MCP client

Point a client that supports remote MCP servers over streamable HTTP at the plain endpoint. No API key, OAuth credentials or request headers are required. The `.mcp.json` file in this repository is a ready-made `mcpServers` entry that uses it:

```json
{
  "mcpServers": {
    "layiq-jobs": {
      "url": "https://www.layiq.co/mcp"
    }
  }
}
```

`server.json` in this repository describes the same endpoint for the [Official MCP Registry](https://modelcontextprotocol.io/registry/quickstart) format.

## Links

- Claude setup guide: <https://www.layiq.co/connectors/claude>
- Connector privacy notice: <https://www.layiq.co/connectors/privacy>
- Privacy policy: <https://www.layiq.co/privacy>
- Support and contact: <https://www.layiq.co/support>

What you type into a search is sent to LAYIQ and can contain personal information if you include it. The privacy notice above describes how it is handled.

## Trademarks

Claude, ChatGPT, Cursor and other product names are trademarks of their respective owners. Naming a client here describes how to configure it and does not imply any partnership with or endorsement by its owner.

## License

See the [LICENSE](LICENSE) file. It covers the documentation and configuration in this repository only, not the LAYIQ website or service.