mcp-lever

mcp-lever

Leverは、何千もの企業が採用活動に利用している採用ソフトウェアで、すべての顧客に公開求人ページが付属します。各ページには、その企業の募集中のポジションが掲載されており、職種名、勤務地、所属するチームと部門、求められる雇用形態、求人広告の全文、企業が公開を選択した場合は給与範囲が記載されています。Leverは、グローバルインスタンスまたは欧州インスタンスのいずれかに、企業ごとの求人ページをホストしていますが、それらを横断するインデックスは公開していません。

このサーバーは、チャットクライアントをそれらの求人ページに接続します。関心のある企業名を指定すると、それぞれの名前を求人ページのURLに使われるサイト名に変換し、求人を検索します。勤務地、チーム、勤務形態、国、給与、掲載時期で絞り込んだり、個々の求人の全文を読み取ったり、各企業が絞り込みに使っている表記を一覧表示したりできます。API キーもアカウントも必要ありません。

Version française

---

インストール

ワンクリックインストール

Claude Code

claude mcp add lever -- npx -y mcp-lever

Claude Desktop、Cursor、および標準の設定形式を使用するクライアント

{
  "mcpServers": {
    "lever": {
      "command": "npx",
      "args": ["-y", "mcp-lever"]
    }
  }
}

Node 24 以降が必要です。環境変数の設定は不要です。

Docker を使用する場合

{
  "mcpServers": {
    "lever": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-lever:2.0.1"]
    }
  }
}

-i はプロトコルが流れる標準入力を開いたままにし、-t は TTY がストリームを書き換えるため指定していません。コンテナに必要なのは api.lever.co と api.eu.lever.co への HTTPS のアウトバウンド通信だけです。ボリューム、ポート、認証情報は必要ありません。

npm を使わないバンドル

最新リリースから mcp-lever-2.0.1.mcpb をダウンロードして開きます。MCP バンドルに対応したクライアントであれば、自動的にインストールされます。npm も、編集が必要な設定ファイルもありません。バンドルには依存関係が含まれているため、インストール時に何かを取得することもありません。

質問できること

• 「Included Health、Netlify、Rampのうち、Leverで採用中の企業はどれですか？」
• 「その3社で、リモート勤務のエンジニア職を探してください。」
• 「その募集内容をすべて読み上げてください。」
• 「Included Healthは、求人の勤務地としてどこを掲載していますか？」
• 「Netlifyで過去2週間に掲載されたものはありますか？」

Leverでは複数の採用ページを横断して検索できないため、どの質問も企業名から始めます。 search_jobs が指定された企業名を解決するため、事前準備は不要です。

resolve_company(["Included Health"])  ->  includedhealth, global instance, publishing
search_jobs(["Included Health"], keyword: "therapist")
get_job("includedhealth", "6f97a19f-…")

ツール

ツール	機能
resolve_company	企業名を、その企業の採用ページのLeverサイト名に変換します。
search_jobs	指定した企業の求人を検索します。
get_job	求人内容を、掲載広告も含めてすべて読み取ります。
list_filter_values	企業が求人を分類する際に使う表記を一覧表示します。

Leverのサイト名では大文字と小文字が区別されるため、Flex なら結果が返りますが、flex では何も返りません。2つのインスタンスそれぞれで名前ごとに4通りの表記を試し、送信した内容も回答に示されるため、何も見つからなかったとしても、その企業がLeverに存在しない証拠にはなりません。

resolve_company

企業名をLeverのサイト名に変換し、応答したすべてのインスタンスを報告します。リストを受け取ります。

引数	型	必須	機能
names	1～25個の文字列を含む配列	はい	企業名、または既知のLeverサイト名。

返される内容： 名前ごとに1つのエントリーが返されます。input、found（{ slug, instance, publishes } のリスト。publishes は、サイトが存在していても本日時点で求人が掲載されていない場合に false になります）、tried（試した表記の順序付きリスト）、cached（このセッションですでにその名前を解決している場合は true）が含まれます。名前が両方のインスタンスで見つかった場合は両方が返され、どちらかが選ばれることはありません。ほかのツールに渡す際は、使用する方を指定してください。

search_jobs

指定された企業の求人を検索します。Lever は、自身がサポートするフィルターを独自の正確な表記に基づいて適用し、このサーバーは読み込んだ求人に残りのフィルターを適用します。

引数	型	必須	動作
companies	1〜25 個の文字列の配列	はい	企業名または Lever のサイト名です。ここでそれぞれ解決します。
keyword	文字列	いいえ	タイトルと求人広告から検索する語句です。
location	1〜20 個の文字列の配列	いいえ	Lever が記載しているとおりの勤務地です。
team	1〜20 個の文字列の配列	いいえ	Lever が記載しているとおりのチームです。
department	1〜20 個の文字列の配列	いいえ	Lever が記載しているとおりの部門です。
commitment	1〜20 個の文字列の配列	いいえ	Lever が記載しているとおりの雇用形態です。
workplace_type	1〜4 個の文字列の配列	いいえ	remote、hybrid、onsite または unspecified です。
country	1〜20 個の 2 文字コードの配列	いいえ	FR や US のような ISO コードで表した国です。
salary_min	0 以上の数値	いいえ	残す給与範囲の上限のうち、最も低い額です。
salary_interval	文字列	いいえ	per-year-salary など、salary_min の期間です。
currency	3 文字コード	いいえ	EUR のように、salary_min が表記されている通貨です。
posted_within_days	1〜3650 の整数	いいえ	求人の掲載時期の上限日数です。
limit	1〜100 の整数、デフォルトは 25	いいえ	企業ごとに読み込む求人の件数です。
skip	0〜100000 の整数、デフォルトは 0	いいえ	企業ごとに読み飛ばす求人の件数です。

Lever 自体が location、team、department、commitment を適用します。このサーバーは、読み込んだ求人に keyword、workplace_type、country、salary_min、salary_interval、currency、posted_within_days を適用します。list_filter_values では最初の 4 つが受け付ける表記を確認できます。Lever が認識しない表記を指定すると、空のリストが返されます。

戻り値： jobs。各項目には、get_job が受け取る id と company_slug のほか、title、location、all_locations、country、workplace_type、team、posted_at、url、apply_url が含まれます。企業側に記録がない場合、commitment と department は含まれません。給与を記載せずに公開された求人では salary は null です。これは決して 0 と同じではありません。また、Lever が記載した interval が含まれ、換算や年換算は行われません。per_company には企業ごとの結果が 1 件ずつ含まれ、status は read、unresolved、empty、failed のいずれかです。これらはそれぞれ異なる結果を示し、フィルター適用前後の件数も含まれます。Lever は結果件数を公開していないため、total_available は常に null です。企業によっては求人ボードが数メガバイトに及ぶため、各行に求人広告の本文は含まれません。

limit は企業ごとに適用され、求人が上限に達した企業では、さらに求人が公開されている場合があります。その場合は注記に記載されます。また、その範囲内で数えた件数は、その範囲の件数です。posted_within_days を指定すると企業ごとに最大 5 ページを確認します。Lever はタイトル順にページ分割するため、昨日公開された求人が求人ボードのどこに掲載されているかは分かりません。

get_job

1 件の求人について、公開されている募集要項、名称の付いたセクション、給与を含む全情報を取得します。

Argument	Type	Required	What it does
company_slug	string	yes	resolve_company が返す、Lever サイト名です。
job_id	string	yes	検索結果で返される、1 件の求人の識別子です。
instance	global or eu	no	行が取得されたインスタンスです。デフォルトは global です。

返される値： 検索結果の行に含まれるフィールドを持つ job と、description、{ heading, items } 形式の sections、給与範囲の横に会社が記載した内容を示す salary_note、取得元のアドレスを含む source です。

list_filter_values

会社が使用するチーム、勤務地、雇用形態の表記を一覧表示します。フィルタリングの前に実行してください。Lever は独自の表記に一致させるため、使用する語彙は会社ごとに異なります。ある会社が Full-time と記載している一方で、別の会社は EE Full-Time と記載しています。

Argument	Type	Required	What it does
company_slug	string	yes	resolve_company が返す、Lever サイト名です。
instance	global or eu	no	このサイトが存在するインスタンスです。デフォルトは global です。
fields	array of 1 to 3 of team, location, commitment	no	取得する語彙です。それぞれに 1 回リクエストが必要で、デフォルトでは 3 つすべてを取得します。

返される値： company_slug、instance、および各語彙について { value, count } の一覧を含む fields です。Lever がカテゴリに併記する件数を公開していない場合、count は null になります。

設定

設定は不要です。サーバーは環境変数を読み取らず、上記の mcpServers ブロックだけで設定は完了します。

リクエスト間隔、タイムアウト、キャッシュはクライアント層の設定であり、ライブラリとしての利用方法で指定方法を説明します。リクエスト間隔は広げることはできますが、短くすることはできません。

エラー

エラーには必ず 6 種類のコードのいずれかとメッセージが含まれます。また、役立つ場合は受け付けられる値も含まれます。

Code	What happened	What to do
not_found	Lever が応答しましたが、そのサイトまたは求人は存在しません。	resolve_company でサイト名を確認してください。
invalid_input	リクエストが送信される前に、引数が拒否されました。	引数名と受け付けられる値を示すメッセージを確認してください。
rate_limited	Lever がこのクライアントにリクエストを遅らせるよう求めました。	待ってから、同じ引数で再度呼び出してください。求人は引き続き掲載されています。
parse_failure	Lever は応答しましたが、このクライアントでは読み取れない形式でした。	イシュートラッカーで報告してください。
network_error	リクエストが完了しませんでした。	少し待ってから再試行してください。
timeout	リクエストが期限を超過しました。	対象企業を減らすか、limit を小さくしてください。

ライブラリとして

Lever を読み取るレイヤーは、独自のペーシング、キャッシュ、エラー処理を備え、プロトコルに依存しない形で単独公開されています。

import { Client } from "mcp-lever/client";

const client = new Client({ minIntervalMs: 2000 });
const resolved = await client.resolveCompany("Included Health");
const jobs = await client.listPostings(resolved.found[0], { limit: 10 });
console.log(jobs.length);

ClientOptions では、minIntervalMs、timeoutMs、cacheTtlMs、fetchImpl を指定します。公開されている下限を下回る間隔は無視されるため、ここでも下限が適用されます。

ペーシングとクレジット表記

どちらの API ホストも Crawl-delay: 1 を公開しているため、リクエストは一度に 1 件ずつ送信され、最低 1 秒の間隔が空きます。この下限は、クライアントの設定にかかわらず適用されます。User-Agent にはプロジェクト名と連絡可能な担当者のアドレスを記載し、ブラウザーを装うことはありません。

読み取り先は api.lever.co と api.eu.lever.co です。これらは Lever が求人データ用として案内しているホストです。jobs.lever.co の採用ページにはアクセスしません。

すべての求人情報には、Lever の掲載ページのアドレスと応募 URL が含まれます。求人情報を表示する際は、企業名を明記し、その掲載ページにリンクしてください。

この MCP サーバーは非公式のプロジェクトであり、Lever または掲載情報を読み取る企業とは一切関係ありません。

プライバシー

このサーバーはあなたに関する情報を一切収集せず、作成者にも何も送信しません。マシン上で動作し、api.lever.co と api.eu.lever.co にのみ接続します。実行中は結果をメモリーに保持し、ディスクには何も書き込みません。 PRIVACY.md では、リクエストに含まれる情報と、それを変更する設定について説明しています。

開発

npm install
npm run build:fixtures
npm test
npm run check

テストは生成されたフィクスチャに対して実行され、ネットワークリクエストは行いません。ライブテストスイートの npm run test:live はルートごとに 1 件のリクエストを行い、サービス自体に対して毎晩実行されます。

貢献

バグ、質問、アイデアは イシュートラッカーにお寄せください。プルリクエストも歓迎します。まずイシューを作成しておくと、変更内容の方向性を合意しやすくなります。CONTRIBUTING.md をご覧ください。

ライセンス

MIT です。詳細は LICENSE をご覧ください。求人情報の権利は、それを公開した企業に帰属します。

---

mcp-lever (フランス語)

英語版

Lever は、何千もの企業が採用活動に利用している採用ソフトウェアです。利用企業にはそれぞれ、公開求人サイトが提供されます。各サイトには、その企業の募集中の職種が掲載され、職種名、勤務地、チームと所属部門、希望する雇用形態、求人の全文、さらに企業が公開を選択した場合は給与レンジが記載されています。Lever は企業ごとに 1 つのサイトをホストしており、グローバルまたはヨーロッパのインスタンスで運営していますが、それらを横断するインデックスは公開していません。

このサーバーは、会話型クライアントをこれらのサイトに接続します。関心のある企業名を指定すると、各社のサイトにアクセスするための識別子に変換し、求人を検索して、勤務地、チーム、勤務形態、国、給与、公開日の新しさで絞り込みます。また、求人の全文を読み込んだり、各企業が求人を分類する際に使っている表記を一覧表示したりできます。API キーもアカウントも必要ありません。

インストール

ワンクリックインストール

Claude Code

claude mcp add lever -- npx -y mcp-lever

Claude Desktop、Cursor、および標準の設定形式に対応するすべてのクライアント

{
  "mcpServers": {
    "lever": {
      "command": "npx",
      "args": ["-y", "mcp-lever"]
    }
  }
}

Node 24 以降が必要です。環境変数の設定は不要です。

Docker を使用

{
  "mcpServers": {
    "lever": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-lever:2.0.1"]
    }
  }
}

-i はプロトコルのチャネルとなる標準入力を開いたままにします。TTY はストリームを書き換えるため、-t は省略します。コンテナに必要なのは api.lever.co と api.eu.lever.co への HTTPS の送信アクセスだけです。それ以外は必要ありません。ボリューム、ポート、認証情報は不要です。

npm なしで使えるバンドル

最新リリースから mcp-lever-2.0.1.mcpb をダウンロードして開きます。MCP バンドルに対応したクライアントなら、npm も設定ファイルの変更も不要で、自動的にインストールします。バンドルには依存関係が含まれているため、インストール時にダウンロードは発生しません。

できること

• 「Included Health、Netlify、Ramp のうち、Lever で採用中なのはどこですか？」
• 「この 3 社のリモート勤務可能なエンジニアリング職を探してください。」
• 「この求人情報を全文読み上げてください。」
• 「Included Health はどのような勤務地で求人を分類していますか？」
• 「Netlify で過去 15 日間に公開された求人はありますか？」

Lever には企業のサイトを横断する検索機能がないため、どの質問も企業を起点にします。search_jobs は指定された名前を自分で解決するため、事前準備は不要です。

resolve_company(["Included Health"])  ->  includedhealth, instance mondiale, publie
search_jobs(["Included Health"], keyword: "therapist")
get_job("includedhealth", "6f97a19f-…")

ツール

ツール	説明
resolve_company	企業名を Lever サイトの識別子に変換します。
search_jobs	指定した企業の求人を検索します。
get_job	求人情報を告知を含めて全文読み上げます。
list_filter_values	企業が求人を分類する際の表現を一覧表示します。

Lever のサイト識別子では大文字と小文字が区別されるため、Flex なら見つかっても、flex では何も返されないことがあります。それぞれの名前について、2 つのインスタンスで 4 通りの綴りを試し、送信した内容を応答に一覧表示します。見つからなかったとしても、その企業が Lever に存在しない証拠にはなりません。

resolve_company

企業名を Lever サイトの識別子に変換し、応答した各インスタンスを示します。名前のリストを受け取ります。

引数	型	必須	説明
names	1～25 個の文字列からなる配列	はい	企業名、または既知の識別子。

戻り値： 名前ごとに 1 つのエントリを返し、input、{ slug, instance, publishes } のリストである found、試した綴りを順に並べた tried、このセッションですでにその名前を解決していた場合は true となる cached を含みます。publishes は、サイトが存在するものの、今日求人を掲載していない場合に false になります。名前が両方のインスタンスで見つかった場合は、どちらも返され、片方が優先されることはありません。対象とするインスタンスを選んで、ほかのツールに渡してください。

search_jobs

指定した企業の求人を検索します。Lever は、自身が扱うフィルターを完全一致する表現に対して適用し、このサーバーは読み取った求人に対してその他のフィルターを適用します。

引数	型	必須	説明
companies	1～25 個の文字列の配列	はい	企業名または識別子です。それぞれここで解決されます。
keyword	文字列	いいえ	求人タイトルと求人票内で検索する語句です。
location	1～20 個の文字列の配列	いいえ	Lever が記載しているとおりの勤務地です。
team	1～20 個の文字列の配列	いいえ	Lever が記載しているとおりのチームです。
department	1～20 個の文字列の配列	いいえ	Lever が記載しているとおりの部門です。
commitment	1～20 個の文字列の配列	いいえ	Lever が記載しているとおりの契約形態です。
workplace_type	1～4 個の文字列の配列	いいえ	remote、hybrid、onsite、または unspecified です。
country	1～20 個の2文字コードの配列	いいえ	FR や US などの ISO 国コードです。
salary_min	0 以上の数値	いいえ	残す年収範囲の下限です。
salary_interval	文字列	いいえ	salary_min の期間です。例：per-year-salary。
currency	3文字コード	いいえ	EUR など、salary_min の通貨です。
posted_within_days	1～3650 の整数	いいえ	求人の最大掲載期間（日数）です。
limit	1～100 の整数、既定値は 25	いいえ	企業ごとに読み込む求人件数です。
skip	0～100000 の整数、既定値は 0	いいえ	企業ごとに読み飛ばす求人件数です。

Lever が location、team、department、commitment を適用し、このサーバーは読み込んだ求人に対して keyword、workplace_type、country、salary_min、salary_interval、currency、posted_within_days を適用します。list_filter_values は最初の4項目で使用できる表記を公開します。Lever が認識しない表記を指定すると、空のリストが返されます。

戻り値： jobs。各求人には id と company_slug が含まれ、これらは get_job で使用します。また、title、location、all_locations、country、workplace_type、team、posted_at、url、apply_url も含まれます。企業が commitment と department を設定していない場合、これらは含まれません。範囲を指定せずに掲載された求人の salary は null です。これは決してゼロを意味せず、Lever が記載した interval のままで、変換も年換算もされません。per_company は企業ごとの結果を示し、status は read、unresolved、empty、failed のいずれかです。これらはそれぞれ異なる結果を表し、フィルター適用前後の read 件数と returned 件数も示します。Lever は結果件数を公開していないため、total_available は常に null です。企業のサイトによっては数メガバイトに達するため、一覧には求人票の本文は含まれません。 limit は企業ごとに適用されます。掲載中の求人が上限に達した企業では、さらに多くの求人が公開されている場合があります。その点は注記に記載されており、この範囲内で取得した件数が範囲全体の件数であることも示されています。posted_within_days は企業ごとに最大 5 ページを調べます。また、Lever は職種名ごとにページ分割するため、昨日公開された求人がサイト内のどこにあるかはわかりません。

get_job

求人の全文を読み込みます。求人情報、名前付きセクション、公開時の給与情報が含まれます。

引数	型	必須	説明
company_slug	文字列	はい	resolve_company が返すサイトの識別子です。
job_id	文字列	はい	検索結果が返す求人の識別子です。
instance	global または eu	いいえ	この求人の行が取得されたインスタンスです。既定値はグローバルです。

戻り値： job。検索結果の行のフィールドに加え、description、{ heading, items } 形式の sections、企業が給与範囲とともに記載した内容を表す salary_note、求人を読み込んだ元のアドレスを含む source が含まれます。

list_filter_values

企業が使用しているチーム、勤務地、雇用形態の表記を一覧表示します。フィルターを使う前に確認してください。Lever は独自の表記に一致するため、用語は企業ごとに異なります。ある企業は Full-time と表記し、別の企業は EE Full-Time と表記します。

引数	型	必須	説明
company_slug	文字列	はい	resolve_company が返すサイトの識別子です。
instance	global または eu	いいえ	このサイトが存在するインスタンスです。既定値はグローバルです。
fields	team、location、commitment から 1～3 個の配列	いいえ	読み込む用語一覧です。各項目で 1 回リクエストし、既定では 3 項目すべてを読み込みます。

戻り値： company_slug、instance、および fields。fields には、要求された各用語一覧の { value, count } が含まれます。Lever がカテゴリの横に件数を公開していない場合、count は null です。

設定

設定は不要です。サーバーは環境変数を読み込まず、上記の mcpServers ブロックをそのまま使用できます。

リクエスト間隔、タイムアウト、キャッシュはクライアント層で設定します。設定方法はライブラリとして使用するで説明しています。リクエスト間隔は広げることはできますが、狭めることはできません。

エラー

各エラーには6種類のコードのいずれか、メッセージ、そして参考になる場合は受け付けられる値が含まれます。

コード	発生したこと	対処方法
not_found	Lever から応答がありましたが、そのサイトも求人もありません。	resolve_company で識別子を確認してください。
invalid_input	リクエストを送信する前に引数が拒否されました。	メッセージを確認してください。対象の引数と受け付ける値が示されています。
rate_limited	Lever から、このクライアントにリクエストを控えるよう求められています。	待ってから、同じ引数で再度呼び出してください。求人は引き続き公開されています。
parse_failure	Lever から、このクライアントが読み取れない形式で応答がありました。	問題トラッカーで報告してください。
network_error	リクエストが完了しませんでした。	少し待ってから再試行してください。
timeout	リクエストがタイムアウトしました。	企業数を減らすか、limit を小さくしてください。

ライブラリとして

Lever を読み取るレイヤーは、プロトコルに依存しない形で、独自のリクエスト間隔、キャッシュ、エラー処理とともに単独で公開されています。

import { Client } from "mcp-lever/client";

const client = new Client({ minIntervalMs: 2000 });
const resolved = await client.resolveCompany("Included Health");
const jobs = await client.listPostings(resolved.found[0], { limit: 10 });
console.log(jobs.length);

ClientOptions では minIntervalMs、timeoutMs、cacheTtlMs、fetchImpl を指定できます。 公開されている最小間隔より短い値は無視されるため、ここでも最小間隔が適用されます。

リクエスト間隔と帰属表示

2つの API ホストはどちらも Crawl-delay: 1 を公開しているため、リクエストは1件ずつ送信され、少なくとも1秒の間隔が空きます。この最小間隔は、クライアントの設定にかかわらず適用されます。User-Agent にはプロジェクト名と連絡可能なアドレスが含まれ、ブラウザーを装うことはありません。

読み取り先は、Lever が求人データ用としてドキュメントで案内しているホスト、api.lever.co と api.eu.lever.co です。採用情報ページの jobs.lever.co にはアクセスしません。

各求人には Lever のページと応募ページのアドレスが記載されています。求人を掲載する際は企業名を明記し、そのページへのリンクを掲載してください。

この MCP は非公式プロジェクトであり、Lever や、サイトの情報を読み取る企業とは提携していません。

プライバシー

このサーバーは、あなたに関する情報を収集せず、作者に情報を送信することもありません。お使いのマシン上で動作し、api.lever.co と api.eu.lever.co 以外には接続せず、動作中のみ応答をメモリに保持し、ディスクには何も書き込みません。PRIVACY.md には、リクエストに含まれる情報と、それを変更する設定が記載されています。

開発

npm install
npm run build:fixtures
npm test
npm run check

テストでは生成されたフィクスチャを使用し、リクエストは送信しません。ライブテストの npm run test:live は、各ルートにつき1件のリクエストを送信し、毎晩サービス自体に対して実行されます。

貢献

問題、質問、アイデアは問題トラッカーにお寄せください。変更の提案も歓迎します。まずチケットを作成すると、変更の方向性を事前にすり合わせられます。CONTRIBUTING.mdをご覧ください。

ライセンス

MIT ライセンスです。LICENSEをご覧ください。求人は、掲載した企業に帰属します。