hirelayer-mcp 1.0.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +36 -16
- package/dist/index.js +0 -0
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -6,16 +6,18 @@
|
|
|
6
6
|
|
|
7
7
|
**Resume parsing, candidate matching and candidate ranking for AI agents.**
|
|
8
8
|
|
|
9
|
-
The official [Model Context Protocol](https://modelcontextprotocol.io) server for [HireLayer](https://hirelayer.co). Parse resumes and CVs, turn job descriptions into criteria, then score and rank candidates from Claude, Cursor, VS Code, Codex or any MCP client.
|
|
9
|
+
The official [Model Context Protocol](https://modelcontextprotocol.io) server for [HireLayer](https://hirelayer.co). Parse resumes and CVs, turn job descriptions into criteria, then score and rank candidates from Claude, ChatGPT, Cursor, VS Code, Codex or any MCP client.
|
|
10
|
+
|
|
11
|
+
**Server URL: `https://hirelayer.co/mcp`** · sign in with your HireLayer account, no API key to copy.
|
|
10
12
|
|
|
11
13
|
[](https://www.npmjs.com/package/hirelayer-mcp)
|
|
12
14
|
[](https://github.com/hirelayer/hirelayer-mcp/actions/workflows/ci.yml)
|
|
13
15
|
[](LICENSE)
|
|
14
16
|
[](https://modelcontextprotocol.io)
|
|
15
17
|
|
|
16
|
-
[](https://cursor.com/install-mcp?name=hirelayer&config=
|
|
17
|
-
[](https://vscode.dev/redirect/mcp/install?name=hirelayer&
|
|
18
|
-
[](https://insiders.vscode.dev/redirect/mcp/install?name=hirelayer&
|
|
18
|
+
[](https://cursor.com/install-mcp?name=hirelayer&config=eyJ1cmwiOiJodHRwczovL2hpcmVsYXllci5jby9tY3AifQ%3D%3D)
|
|
19
|
+
[](https://vscode.dev/redirect/mcp/install?name=hirelayer&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fhirelayer.co%2Fmcp%22%7D)
|
|
20
|
+
[](https://insiders.vscode.dev/redirect/mcp/install?name=hirelayer&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fhirelayer.co%2Fmcp%22%7D&quality=insiders)
|
|
19
21
|
[](https://lmstudio.ai/install-mcp?name=hirelayer&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImhpcmVsYXllci1tY3AiXSwiZW52Ijp7IkhJUkVMQVlFUl9BUElfS0VZIjoieW91ci1hcGkta2V5In19)
|
|
20
22
|
|
|
21
23
|
</div>
|
|
@@ -48,17 +50,34 @@ Use it to screen applicants in a chat, build a recruiting agent, enrich an ATS,
|
|
|
48
50
|
|
|
49
51
|
## Quick start
|
|
50
52
|
|
|
51
|
-
1. **
|
|
52
|
-
2. **
|
|
53
|
-
3. **Ask your assistant.** For example:
|
|
54
|
-
|
|
55
|
-
To try it without your own data, use the sample job and resumes in [`examples/`](examples).
|
|
53
|
+
1. **Add the server URL** `https://hirelayer.co/mcp` in your AI app, or click a one-click install button above.
|
|
54
|
+
2. **Sign in to HireLayer** when your app asks, and allow access. No account yet? [Sign up for free](https://hirelayer.co/auth/signup): 50 credits a month, no card required.
|
|
55
|
+
3. **Ask your assistant.** For example: attach a resume and ask *"Summarize this candidate."*
|
|
56
56
|
|
|
57
|
-
|
|
57
|
+
To try it without your own data, use the sample job and resumes in [`examples/`](examples). The repository ships a [`.mcp.json`](.mcp.json): clone it, export `HIRELAYER_API_KEY`, open the folder in Claude Code and it offers to enable the local server.
|
|
58
58
|
|
|
59
59
|
## Install in your MCP client
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
### Hosted server (recommended)
|
|
62
|
+
|
|
63
|
+
Connect to `https://hirelayer.co/mcp` and sign in to HireLayer. Nothing to install, nothing to keep up to date.
|
|
64
|
+
|
|
65
|
+
| Client | How to connect |
|
|
66
|
+
|---|---|
|
|
67
|
+
| **Claude** (web, desktop, mobile) | Settings → Connectors → **Add custom connector**, paste the URL, then **Connect** |
|
|
68
|
+
| **ChatGPT** | Settings → Apps → turn on developer mode, create an app with the URL and OAuth authentication |
|
|
69
|
+
| **Claude Code** | `claude mcp add --transport http hirelayer https://hirelayer.co/mcp`, then `/mcp` to sign in |
|
|
70
|
+
| **Cursor** | Click **Install in Cursor** above, or add `{ "mcpServers": { "hirelayer": { "url": "https://hirelayer.co/mcp" } } }` to `~/.cursor/mcp.json` |
|
|
71
|
+
| **VS Code** | Click **Install in VS Code** above, or add `{ "servers": { "hirelayer": { "type": "http", "url": "https://hirelayer.co/mcp" } } }` to `.vscode/mcp.json` |
|
|
72
|
+
| **Codex CLI** | `codex mcp add hirelayer --url https://hirelayer.co/mcp`, then `codex mcp login hirelayer` |
|
|
73
|
+
|
|
74
|
+
Clients that cannot sign in with OAuth can send a HireLayer API key instead: `Authorization: Bearer your-api-key`.
|
|
75
|
+
|
|
76
|
+
The hosted `parse_resume` takes a file attached in ChatGPT, a public HTTPS URL, a small file in base64 or the resume text. To parse files from your disk, run the server locally.
|
|
77
|
+
|
|
78
|
+
### Local server (npx)
|
|
79
|
+
|
|
80
|
+
Runs on your machine with an API key: [sign up](https://hirelayer.co/auth/signup), then copy your key from **Dashboard → API keys** and replace `your-api-key` below.
|
|
62
81
|
|
|
63
82
|
<details open>
|
|
64
83
|
<summary><b>Claude Code</b></summary>
|
|
@@ -93,7 +112,7 @@ Restart Claude Desktop.
|
|
|
93
112
|
<details>
|
|
94
113
|
<summary><b>Cursor</b></summary>
|
|
95
114
|
|
|
96
|
-
|
|
115
|
+
Add this to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
|
|
97
116
|
|
|
98
117
|
```json
|
|
99
118
|
{
|
|
@@ -112,7 +131,7 @@ Click **Install in Cursor** above, or add this to `~/.cursor/mcp.json` (all proj
|
|
|
112
131
|
<details>
|
|
113
132
|
<summary><b>VS Code (GitHub Copilot)</b></summary>
|
|
114
133
|
|
|
115
|
-
|
|
134
|
+
Add this to `.vscode/mcp.json`. VS Code asks for your API key and stores it securely:
|
|
116
135
|
|
|
117
136
|
```json
|
|
118
137
|
{
|
|
@@ -282,7 +301,8 @@ Each successful tool call costs **1 HireLayer credit**. A `rank_candidates` call
|
|
|
282
301
|
|
|
283
302
|
## Data and privacy
|
|
284
303
|
|
|
285
|
-
- The server
|
|
304
|
+
- The hosted server receives only what your assistant sends to HireLayer tools. Each app gets access only after you sign in and allow it, and you can disconnect it at any time.
|
|
305
|
+
- The local server runs **on your machine** and calls the HireLayer API over HTTPS with your API key. It has no telemetry.
|
|
286
306
|
- `parse_resume` reads only the file you name. By default HireLayer stores the original file and returns a link to it in `info_resume.url`. Set `do_not_store_data: true` in a call so the file is not stored.
|
|
287
307
|
- See the [privacy policy](https://hirelayer.co/privacy-policy) and the [security policy](SECURITY.md).
|
|
288
308
|
|
|
@@ -326,8 +346,8 @@ The parser detects the main language of each resume and returns it in `info_resu
|
|
|
326
346
|
**Can I use the REST API directly?**
|
|
327
347
|
Yes. See the [API reference](https://hirelayer.co/api-docs), the [OpenAPI spec](https://hirelayer.co/openapi.json) and [`llms.txt`](https://hirelayer.co/llms.txt) for agents.
|
|
328
348
|
|
|
329
|
-
**
|
|
330
|
-
|
|
349
|
+
**Do I need an API key?**
|
|
350
|
+
Not with the hosted server: you sign in to HireLayer and allow access, and the app's calls use your plan's credits. Each connected app appears as an "(MCP)" key in **Dashboard → API keys**; revoke it to disconnect the app. The local server uses an API key.
|
|
331
351
|
|
|
332
352
|
## Development
|
|
333
353
|
|
package/dist/index.js
CHANGED
|
File without changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "hirelayer-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.1.0",
|
|
4
4
|
"mcpName": "co.hirelayer/hirelayer",
|
|
5
5
|
"description": "Official HireLayer MCP server: resume and CV parsing, job criteria extraction, candidate matching and ranking, and skills normalization for AI agents in Claude, Cursor, VS Code and other MCP clients.",
|
|
6
6
|
"type": "module",
|
|
@@ -40,13 +40,13 @@
|
|
|
40
40
|
"claude",
|
|
41
41
|
"cursor"
|
|
42
42
|
],
|
|
43
|
-
"homepage": "https://github.com/
|
|
43
|
+
"homepage": "https://github.com/HireLayer/hirelayer-mcp#readme",
|
|
44
44
|
"repository": {
|
|
45
45
|
"type": "git",
|
|
46
|
-
"url": "git+https://github.com/
|
|
46
|
+
"url": "git+https://github.com/HireLayer/hirelayer-mcp.git"
|
|
47
47
|
},
|
|
48
48
|
"bugs": {
|
|
49
|
-
"url": "https://github.com/
|
|
49
|
+
"url": "https://github.com/HireLayer/hirelayer-mcp/issues"
|
|
50
50
|
},
|
|
51
51
|
"author": "HireLayer <contact@hirelayer.co> (https://hirelayer.co)",
|
|
52
52
|
"license": "MIT",
|