# SmartRecruiters MCP by usefulapi

> SmartRecruiters MCP by usefulapi is an MCP server. Search jobs and candidates, read applications, and add candidate tags in SmartRecruiters. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/smartrecruiters/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/smartrecruiters
- **MCP Registry name:** io.usefulapi/smartrecruiters
- **Listing updated:** 2026-11-13

## About

Search jobs and candidates, read applications, and add candidate tags in SmartRecruiters.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http smartrecruiters https://smartrecruiters.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://smartrecruiters.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "smartrecruiters": {
      "url": "https://smartrecruiters.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "smartrecruiters": {
      "type": "http",
      "url": "https://smartrecruiters.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "smartrecruiters": {
      "serverUrl": "https://smartrecruiters.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "smartrecruiters": {
      "type": "http",
      "url": "https://smartrecruiters.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `smartrecruiters_search_jobs`: Search the company's job requisitions by keyword, status, city, department or update time. Returns content with each job, totalFound and nextPageId. SmartRecruiters: GET /jobs.
- `smartrecruiters_get_job`: Get one job requisition by id: title, status, location, department and hiring team. SmartRecruiters: GET /jobs/{jobId}.
- `smartrecruiters_search_candidates`: Search candidates who have at least one job application, by keyword, job, status, tag or update time. Returns content, totalFound and nextPageId. Call one page at a time: this endpoint allows one concurrent request. SmartRecruiters: GET /candidates.
- `smartrecruiters_get_candidate`: Get one candidate's profile by id: name, contact details, source, tags and properties. SmartRecruiters: GET /candidates/{id}.
- `smartrecruiters_get_candidate_application`: Get one candidate's application to one job: status, substatus, rating and screening answers. SmartRecruiters: GET /candidates/{id}/jobs/{jobId}.
- `smartrecruiters_list_candidate_attachments`: List the files attached to a candidate, such as a CV or cover letter (metadata only). SmartRecruiters: GET /candidates/{id}/attachments.
- `smartrecruiters_search_offers`: Search job offers by status, keyword or posting id. The key must belong to a user with the Extended or Admin system role. SmartRecruiters: GET /offers.
- `smartrecruiters_list_users`: List the users of the company, such as recruiters and hiring managers, with name, email and system role. SmartRecruiters: GET /users.
- `smartrecruiters_add_candidate_tags`: Add tags to one candidate. Existing tags stay; this call never replaces or removes tags. Up to 100 tags, 150 characters each. SmartRecruiters: POST /candidates/{id}/tags.

## FAQ

### How do I add SmartRecruiters MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http smartrecruiters https://smartrecruiters.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/smartrecruiters-mcp-by-usefulapi
