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 mcp add ashby -- npx -y mcp-ashby

Claude Desktop, Cursor, and any client using the standard config format

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

Node 24 or later is required, and no environment variable has to be set.

With Docker

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

`-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:

resolve_board(["Ramp"])          ->  ramp, publishing
search_jobs(["Ramp"], query: "designer", is_remote: true)
get_job("ramp", "b0c8…")

Tools

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.

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.

In return: `jobs`, each carrying `board` and `id`, which `get_job` takes

together, plus `title`, `department`, `team`, `employment_type`, `location`,

`country`, `secondary_location_count`, `workplace_type`, `is_remote`,

`published_at` with the offset Ashby publishes, `compensation_summary`, `job_url`

and `apply_url`. The rows carry no advert text, at any limit.

`total_on_board` counts the postings the boards read hold, `total_matched` those

the criteria kept, and `returned` those in this answer: three different numbers.

`per_company` gives one outcome per company with its `status`, `filters_applied`

echoes what was applied, and `undeclared` counts the postings that declare

nothing on a field being filtered, so a restriction never silently swallows them.

`get_job`

Reads one posting in full.

The advert runs to thousands of characters, and `html` is the company's own

markup, unrewritten.

In return: the posting a search row carries, with its description, its

locations and the pay components the company published.

`list_filter_values`

Lists the words one board actually uses, with how many postings carry each.

In return: `facets`, each value with the number of postings carrying it, and

`undeclared`, the postings declaring nothing on that facet. `sibling_spellings`

names the wordings that differ only in case or spacing, which a filter would

otherwise treat as two different things.

`compare_compensation`

Puts one pay component of several postings side by side.

One component at a time: a share of capital and a salary do not add up.

Postings quoted over another period are listed apart, unconverted.

In return: `rows`, one per posting, with the `component` and the `interval`

they were compared on, `currencies_present` naming every currency in the answer,

and `not_published` listing the postings whose company published nothing, which

is never the same as zero.

What a pay figure means

A company publishes what it chooses. A posting without a range comes back with

none, never with a zero. A range is reported in the currency and over the period

Ashby carries it in, and it is never converted or annualised: comparing two

postings quoted over different periods is left to whoever knows what the

comparison is for.

Configuration

Nothing has to be configured. The server reads no environment variable, and the

`mcpServers` block above is complete as written.

The pacing, the timeout and the cache are settings of the client layer, which

As a library shows how to pass. The interval between two

requests can be widened there and never narrowed.

Errors

Every failure carries one of six codes, a message, and where it helps the values

that would have been accepted.

As a library

The layer reading Ashby is published on its own, with its pacing, its cache and

its errors, and with no protocol attached.

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

const client = new Client({ minIntervalMs: 2000 });
const resolved = await client.resolveBoard("Ramp");
console.log(resolved.found);

`ClientOptions` takes `minIntervalMs`, `timeoutMs`, `cacheTtlMs` and `fetchImpl`.

An interval below the published floor is ignored, so the floor holds here as

well.

Pacing and attribution

Requests go out one at a time with at least a second between them, and that floor

holds however the client is configured. Ashby serves a whole board in one

response, which can weigh megabytes, so a single question about one company costs

one request and this server holds the answer briefly rather than asking again.

The `User-Agent` carries the project and an address where a person can be

reached, and imitates no browser.

Every posting carries the address of its Ashby page and its apply URL. Credit the

company and link that page when you show a posting.

This MCP server is an unofficial project, with no affiliation to Ashby or to the

companies whose boards it reads.

Privacy

This server collects nothing about you and sends nothing to its author. It runs

on your machine, contacts `api.ashbyhq.com` and nothing else, holds its answers

in memory while it runs, and writes nothing to disk.

PRIVACY.md states what a request carries and which settings change

any of it.

Development

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

Tests run against generated fixtures and make no network request. The live suite,

`npm run test:live`, makes one request per route and runs nightly against the

service itself.

Contributing

Bugs, questions and ideas belong in

the issue tracker. Pull requests

are welcome; opening an issue first helps agree on the shape of the change. See

CONTRIBUTING.md.

License

MIT, see LICENSE. The postings belong to the companies that published

them.

mcp-ashby (français)

_English version_

Ashby est un logiciel de recrutement, et chaque

entreprise qui l'utilise reçoit avec lui un site d'offres public. Chaque site

porte les postes ouverts de cette entreprise avec leur intitulé, leur département

et leur équipe, le type de contrat, les lieux et le caractère distant du travail,

l'annonce complète, et, quand l'entreprise a choisi de le publier, la

rémunération : une fourchette de salaire, une part de capital, une commission ou

une prime, chacune avec la période sur laquelle elle est exprimée. Ashby héberge

un site par entreprise et ne publie aucun index les traversant.

Ce serveur relie un client de conversation à ces sites. Vous nommez les

entreprises qui vous intéressent, et il traduit chaque nom en le jeton qui

adresse son site, cherche dans leurs offres, les filtre par département, équipe,

lieu, pays, type de contrat, télétravail, fraîcheur ou rémunération, lit une

offre en entier, liste les mots que chaque site emploie réellement, et met les

rémunérations de plusieurs offres côte à côte. Aucune clé d'API, aucun compte.

Installation

Installation en un clic

Claude Code

claude mcp add ashby -- npx -y mcp-ashby

Claude Desktop, Cursor, et tout client au format de configuration standard

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

Node 24 ou plus récent est nécessaire, et aucune variable d'environnement n'est à

renseigner.

Avec Docker

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

`-i` garde l'entrée standard ouverte, qui est le canal du protocole, et `-t` est

omis parce qu'un TTY réécrit le flux. Le conteneur a besoin d'un accès HTTPS

sortant vers `api.ashbyhq.com`, et de rien d'autre : aucun volume, aucun port,

aucun identifiant.

Bundle, sans npm

Téléchargez `mcp-ashby-2.0.1.mcpb` depuis

la dernière publication

et ouvrez-le. Un client qui gère les bundles MCP l'installe seul, sans npm et

sans fichier de configuration à modifier. Le bundle emporte ses dépendances, donc

rien n'est téléchargé à l'installation.

Ce qu'on peut demander

• « Est-ce que Ramp recrute sur Ashby ? »
• « Trouve-moi des postes de design en télétravail chez Ramp et Linear. »
• « Lis-moi cette offre en entier. »
• « Sous quels départements ce site classe-t-il ses offres ? »
• « Mets côte à côte les salaires de ces offres d'ingénierie. »

Chaque question part d'une entreprise, puisque Ashby n'offre aucune recherche

traversant les sites. `search_jobs` résout lui-même les noms qu'on lui donne,

donc rien n'est à préparer :

resolve_board(["Ramp"])          ->  ramp, publie
search_jobs(["Ramp"], query: "designer", is_remote: true)
get_job("ramp", "b0c8…")

Les outils

Chaque site garde ses propres départements et équipes, donc un filtre écrit dans

le vocabulaire d'un autre site ne retient rien. `list_filter_values` publie les

mots qu'un site emploie réellement.

`resolve_board`

Traduit un nom d'entreprise en le jeton qui adresse son site Ashby.

En retour : `found`, les sites qui ont répondu, et `tried`, les formes

réellement envoyées dans l'ordre. Quatre formes sont essayées par nom, donc ne

rien trouver ne prouve jamais qu'une entreprise est absente d'Ashby.

`search_jobs`

Cherche dans les offres des entreprises nommées. Ashby sert un site entier d'un

coup, et chaque restriction ci-dessous s'applique à ce qui a été lu.

En retour : `jobs`, chacune portant `board` et `id`, que `get_job` reprend

ensemble, plus `title`, `department`, `team`, `employment_type`, `location`,

`country`, `secondary_location_count`, `workplace_type`, `is_remote`,

`published_at` avec le décalage horaire qu'Ashby publie, `compensation_summary`,

`job_url` et `apply_url`. **Les lignes ne portent pas l'annonce, quelle que soit

la limite.** `total_on_board` compte les offres que contiennent les sites lus,

`total_matched` celles que les critères ont retenues, et `returned` celles de

cette réponse : trois nombres différents. `per_company` donne une issue par

entreprise avec son `status`, `filters_applied` redonne ce qui a été appliqué, et

`undeclared` compte les offres qui ne déclarent rien sur un champ filtré, pour

qu'une restriction ne les avale jamais en silence.

`get_job`

Lit une offre en entier.

L'annonce fait des milliers de caractères, et `html` est le balisage de

l'entreprise, non réécrit.

En retour : l'offre que porte une ligne de recherche, avec sa description,

ses lieux et les composantes de rémunération que l'entreprise a publiées.

`list_filter_values`

Liste les mots qu'un site emploie réellement, et combien d'offres portent chacun.

En retour : `facets`, chaque valeur avec le nombre d'offres qui la portent,

et `undeclared`, les offres qui ne déclarent rien sur cette facette.

`sibling_spellings` nomme les formulations qui ne diffèrent que par la casse ou

les espaces, qu'un filtre traiterait sinon comme deux choses distinctes.

`compare_compensation`

Met une composante de rémunération de plusieurs offres côte à côte.

Une composante à la fois : une part de capital et un salaire ne s'additionnent

pas. Les offres exprimées sur une autre période sont listées à part, sans

conversion.

En retour : `rows`, une par offre, avec le `component` et l'`interval` sur

lesquels elles ont été comparées, `currencies_present` qui nomme chaque devise

présente dans la réponse, et `not_published` qui liste les offres dont

l'entreprise n'a rien publié, ce qui ne vaut jamais zéro.

Ce que dit un chiffre de rémunération

Une entreprise publie ce qu'elle veut. Une offre sans fourchette revient sans

rien, jamais avec un zéro. Une fourchette est rendue dans la devise et sur la

période où Ashby la porte, et elle n'est jamais convertie ni annualisée :

comparer deux offres exprimées sur des périodes différentes est laissé à qui sait

à quoi la comparaison doit servir.

Configuration

Il n'y a rien à configurer. Le serveur ne lit aucune variable d'environnement, et

le bloc `mcpServers` ci-dessus est complet tel quel.

Le rythme, le délai et le cache sont des réglages de la couche cliente, que

Comme bibliothèque montre comment passer. L'écart entre

deux requêtes peut y être élargi et jamais resserré.

Erreurs

Chaque échec porte un des six codes, un message, et quand cela aide les valeurs

qui auraient été acceptées.

Comme bibliothèque

La couche qui lit Ashby est publiée seule, avec son rythme, son cache et ses

erreurs, sans protocole attaché.

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

const client = new Client({ minIntervalMs: 2000 });
const resolved = await client.resolveBoard("Ramp");
console.log(resolved.found);

`ClientOptions` prend `minIntervalMs`, `timeoutMs`, `cacheTtlMs` et `fetchImpl`.

Un écart sous le plancher publié est ignoré, donc le plancher tient également

ici.

Rythme et attribution

Les requêtes partent une à une avec au moins une seconde entre elles, et ce

plancher tient quelle que soit la configuration du client. Ashby sert un site

entier en une réponse, qui peut peser plusieurs mégaoctets, donc une question sur

une entreprise coûte une requête et ce serveur garde brièvement la réponse plutôt

que de redemander. Le `User-Agent` porte le projet et une adresse où joindre une

personne, et n'imite aucun navigateur.

Chaque offre porte l'adresse de sa page Ashby et son adresse de candidature.

Créditez l'entreprise et renvoyez vers cette page quand vous montrez une offre.

Ce MCP est un projet non officiel, sans affiliation à Ashby ni aux entreprises

dont il lit les sites.

Confidentialité

Ce serveur ne collecte rien sur vous et n'envoie rien à son auteur. Il tourne sur

votre machine, ne joint que `api.ashbyhq.com`, garde ses réponses en mémoire le

temps qu'il tourne, et n'écrit rien sur le disque. PRIVACY.md dit

ce qu'une requête emporte et quels réglages changent cela.

Développement

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

Les tests s'exécutent sur des fixtures engendrées et n'émettent aucune requête.

La suite en direct, `npm run test:live`, émet une requête par route et tourne

chaque nuit contre le service lui-même.

Contribuer

Les anomalies, les questions et les idées ont leur place dans

le suivi d'incidents. Les

propositions de modification sont bienvenues ; ouvrir un ticket d'abord aide à

s'accorder sur la forme du changement. Voir CONTRIBUTING.md.

Licence

MIT, voir LICENSE. Les offres appartiennent aux entreprises qui les

ont publiées.