smeet666/mcp-ashby

Ashby is recruiting software, and every company using
it gets a public job board that comes with it. Each board carries that company's
open positions with their title, their department and team, the employment type,
the locations and whether the work is remote, the full advert, and, where the
company chose to publish it, the pay: a salary range, an equity share, a
commission or a bonus, each with the period it is quoted over. Ashby holds one
board per company and publishes no index across them.
This server connects a chat client to those boards. You name the companies you
are interested in, and it turns each name into the token that addresses its
board, searches their postings, filters them by department, team, location,
country, employment type, remoteness, recency or pay, reads one posting in full,
lists the words each board actually uses, and puts the pay of several postings
side by side. It needs no API key and no account.
_Version française_
---
Install
**One-click install**
**Claude Code**
**Claude Desktop, Cursor, and any client using the standard config format**
Node 24 or later is required, and no environment variable has to be set.
With Docker
-i keeps stdin open, which is where the protocol travels, and -t is left out
because a TTY rewrites the stream. The container needs outbound HTTPS to
api.ashbyhq.com, and nothing else: no volume, no port, no credential.
Bundle, without npm
Download mcp-ashby-2.0.1.mcpb from
the latest release and
open it. A client that supports MCP bundles installs it on its own, with no npm
and no configuration file to edit. The bundle carries its dependencies, so
nothing is fetched at install time.
What you can ask
- "Is Ramp hiring on Ashby?"
- "Find me remote design roles at Ramp and Linear."
- "Read me that posting in full."
- "What departments does that board file its jobs under?"
- "Put the salaries of those engineering postings side by side."
Every question starts from a company, since Ashby offers no search across boards.
search_jobs resolves the names you give it, so no preparation is needed:
Tools
| Tool | What it does |
| ---------------------- | ------------------------------------------------------------------ |
| resolve_board | Turns a company name into the Ashby board token. |
| search_jobs | Searches the postings of the companies you name. |
| get_job | Reads one posting in full, advert included. |
| list_filter_values | Lists the words one board uses, with how many postings carry each. |
| compare_compensation | Puts one pay component of several postings side by side. |
Every board keeps its own departments and teams, so a filter written from another
board's vocabulary narrows to nothing. list_filter_values publishes the words a
board actually uses.
resolve_board
Turns a company name into the token that addresses its Ashby board.
| Argument | Type | Required | What it does |
| -------- | ------ | -------- | --------------------------------------------------------- |
| name | string | yes | A company name, or an Ashby board token you already know. |
**In return:** found, the boards that answered, and tried, the forms actually
sent in order. Four forms are tried per name, so nothing found is never proof
that a company is absent from Ashby.
search_jobs
Searches the postings of the companies named. Ashby serves a whole board at once,
and every restriction below is applied to what was read.
| Argument | Type | Required | What it does |
| ------------------- | ---------------------------------------------------------------------- | -------- | ------------------------------------------------------ |
| companies | array of 1 to 10 strings | yes | Company names or board tokens. |
| query | string | no | Words to look for. |
| search_in | title or title_and_description, default title | no | Where query is looked for. |
| department | one string or a list of up to 10 | no | Departments as the board spells them. |
| team | one string or a list of up to 10 | no | Teams as the board spells them. |
| employment_type | one string or a list of up to 6 | no | Employment types. |
| workplace_type | one string or a list of up to 4 | no | Workplace types. |
| is_remote | boolean | no | Keep the postings marked remote. |
| country | one country or a list of up to 10 | no | Countries as the board spells them. |
| location_contains | string | no | Part of a location line. |
| published_after | an ISO 8601 date | no | How recent a posting has to be. |
| has_compensation | boolean | no | Keep the postings whose company publishes a pay range. |