> ## Documentation Index
> Fetch the complete documentation index at: https://docs.letsfind.work/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

> Let your AI app search jobs and open the employer's form.

The MCP server gives an AI app the same jobs as the REST API, as tools. Your AI finds jobs, reads one, then opens the employer's apply link and fills the form there itself. The server has no form tool.

Server URL:

```text theme={null}
https://api.letsfind.work/mcp
```

## Two ways to sign in

* **OAuth**: add the URL with no key. Your app opens our sign-in page: sign in with an email link or your LetsFindWork account, then allow the app. Nothing to copy.
* **API key**: send your key in the `Authorization` header: `Authorization: Bearer jobs_...`. Create one on your [account page](https://api.letsfind.work/account).

Both use the same account, credits and rate limit as the REST API. A wrong key gets `401`, like a missing one.

## Connect

### Claude

In Claude, open Settings, then Connectors, and add a custom connector with the server URL. Claude opens our sign-in page.

### ChatGPT

Turn on developer mode in ChatGPT's settings, then create an app (connector) with the server URL and OAuth. ChatGPT opens our sign-in page.

### Claude Code

With OAuth (run `/mcp` in Claude Code to sign in):

```bash theme={null}
claude mcp add --transport http letsfindwork https://api.letsfind.work/mcp
```

With an API key:

```bash theme={null}
claude mcp add --transport http letsfindwork https://api.letsfind.work/mcp \
  --header "Authorization: Bearer $API_KEY"
```

### Other apps

Any MCP client that speaks Streamable HTTP works. Give it the server URL, and either let it sign in with OAuth or set the `Authorization` header.

## Tools, in the order an agent uses them

| Tool | What it does | Credits |
| - | - | - |
| `get_facets` | The filter values in use (countries, ATS, workplace types and more), with counts | Free |
| `search_jobs` | Finds jobs with the same filters as [`GET /v1/jobs`](https://docs.letsfind.work/search) | One per job returned |
| `get_job` | One job with the employer's apply link | One |
| `get_changes` | Jobs created, changed or closed since a cursor, like [`GET /v1/changes`](https://docs.letsfind.work/changes) | One per created or changed job |
| `list_companies` | Companies with open jobs and their ATS | Free |

After `get_job`, the agent opens the apply link and fills the employer's form on their page.

## Credits

The same rule as the REST API: see [Credits](https://docs.letsfind.work/credits.md).

* A job already returned this month is free, from any tool or endpoint.
* Closed jobs are free.
* Paid results show the credits left.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.