# Firmable for recruiters

> Your ATS tracks the candidates and your sourcing agent drafts the outreach. Firmable tells it who works where, how long they've been in the seat, which skills they list and how to reach them.

- Web page: https://developer.firmable.ai/solutions/recruiters
- Get a free API key: https://platform.firmable.com/sign-up
- Full API reference: https://docs.firmable.com/api-reference/overview

Works alongside: Applicant tracking system, CRM for client development, Sourcing or outreach agent.

## From client list to shortlist.

The work behind every hire, agency or in-house: finding candidates, timing every call and, for agencies, winning the client.

### Win new clients

Your sourcing agent asks: "Fintechs in Austin with 50 to 300 staff, and who hires engineers at each."

Find the companies from a plain-English brief, then pull the engineering and talent leaders at each one for business development.

Calls: [`ai_search`](https://docs.firmable.com/api-reference/overview), [`filter_search`](https://docs.firmable.com/api-reference/overview), [`POST /people/search`](https://docs.firmable.com/api-reference/overview)

For recruiters: BD calls go to the person who signs the terms of business.

### Source passive candidates

Your sourcing agent asks: "Senior data engineers who list Snowflake as a skill."

Search people by position and seniority, then confirm each one lists every skill on the job brief.

Calls: [`POST /people/search`](https://docs.firmable.com/api-reference/overview), [`has_skill`](https://docs.firmable.com/api-reference/overview), [`matches_seniority`](https://docs.firmable.com/api-reference/overview)

For recruiters: Shortlists match the brief before a consultant reads a profile.

### Call when they're ready

Your sourcing agent asks: "Who on this shortlist has been in the role three years or more, and who just started?"

Check tenure on each candidate, and flag anyone who has moved since you last spoke.

Calls: [`is_long_tenured`](https://docs.firmable.com/api-reference/overview), [`is_new_to_role`](https://docs.firmable.com/api-reference/overview), [`has_changed_jobs_since`](https://docs.firmable.com/api-reference/overview)

For recruiters: No calls to someone three weeks into a new job.

### Mine alumni networks

Your sourcing agent asks: "Who on our list used to work at the companies our client rates?"

Check candidates against the past employers you name, by company name or Firmable ID.

Calls: [`previously_worked_at`](https://docs.firmable.com/api-reference/overview)

For recruiters: Talent pools from companies your clients already trust.

### Get the hiring manager on the phone

Your sourcing agent asks: "Who leads engineering at this client, and how do we reach them?"

Find the leader, check they can be reached, and check their mobile and that their email is likely to deliver before anyone reaches out.

Calls: [`POST /people/search`](https://docs.firmable.com/api-reference/overview), [`is_reachable`](https://docs.firmable.com/api-reference/overview), [`is_mobile_valid`](https://docs.firmable.com/api-reference/overview), [`is_email_valid`](https://docs.firmable.com/api-reference/overview)

For recruiters: Outreach that connects, to people who hire.

### Target clients hiring for your specialism

Your sourcing agent asks: "Which of our target clients run Snowflake, and which are building AI teams?"

Pull each client's stack to match it to the skills your desk places, and read the hiring and workforce areas of AI adoption to see who is advertising AI roles.

Calls: [`bulk_get_tech_intel`](https://docs.firmable.com/api-reference/overview), [`get_ai_adoption`](https://docs.firmable.com/api-reference/overview)

For recruiters: BD time goes to clients hiring for what you place.

## Example: Check a candidate's tenure

A make_decision call on the Firmable MCP server, with a placeholder profile. Answers about people are a guide, not a firm fact.

```
{
  "name": "make_decision",
  "arguments": {
    "tool": "is_long_tenured",
    "question": { "min_years": 3 },
    "linkedin_url": "https://www.linkedin.com/in/jane-doe"
  }
}
```

## Where it fits on your desk.

- **Beside your ATS.** Call the REST API when a job opens or a candidate is added, with one developer key.
- **In your sourcing agent.** Add the MCP server and brief it in plain English, the way you'd brief a researcher.
- **On a whole shortlist.** Check tenure, skills and reachability for up to 100 people a call.
- **As a guide.** Answers about people come back flagged as a guide, not a firm fact, so a consultant makes the final call.
