Model Context Protocol · Streamable HTTP · read-only

Connect your AI assistant to NiceHire

The NiceHire MCP server lets MCP-capable AI assistants — Claude Code, Claude Desktop, Codex CLI, Cursor, and others — search the live job postings on nicehire.ai and read your own NiceHire data. Every tool is read-only, and every request requires a personal access token from your NiceHire account.

Server endpoint

https://www.nicehire.ai/mcp

Connect directly

Any MCP client that supports remote Streamable HTTP servers can connect to the endpoint without installing anything. For Claude Code:

claude mcp add --transport http nicehire https://www.nicehire.ai/mcp --header "Authorization: Bearer YOUR_TOKEN"

Replace YOUR_TOKEN with a personal access token from your NiceHire dashboard — see the next section.

Get a personal access token

Every request to the server requires a personal access token, and creating one requires a NiceHire account. In your dashboard, open Settings → MCP access:

Talent

Talent dashboard → Settings → MCP access

Open settings

Organization

Organization dashboard → Settings → MCP access

Open settings

Mentor

Mentor dashboard → Settings → MCP access

Open settings

The token is displayed once, at creation — copy it then.
You can revoke a token from the same page at any time; the next request with a revoked token is rejected.
Tokens are read-only: no tool behind them can change anything on your account.

Connector packages

For MCP clients that launch stdio servers, the connector is packaged as four npm packages. The three persona packages are thin launchers over the shared nicehire-mcp engine — same proxy, same endpoint. Which tools your assistant sees is decided by the server from your token's account, not by the package you pick.

Package	Who it is for
`nicehire-mcp`	The shared engine the three persona packages depend on — the general entry point for any account.
`nicehire-mcp-talent`	Talent accounts (job seekers).
`nicehire-mcp-employer`	Employer (organization) accounts.
`nicehire-mcp-mentor`	Mentor accounts.

These packages are not yet available on the npm registry. Until they are, use the direct connection above — it reaches the same server and the same tools.

Tools

All tools are read-only. Every authenticated account gets the four shared tools; accounts holding a talent, employer, or mentor role additionally get that role's tools. The server only ever advertises the tools your account's roles permit.

Shared — every authenticated account

Tool	What it does
`search_jobs`	Search live job postings listed on nicehire.ai by keyword, location, and company name. Returns paginated results; each result carries the canonical URL of its public page.
`get_job`	Fetch the public details of one job posting by id, including the canonical URL of its public page and where to apply. Postings that are no longer listed are reported as unavailable.
`list_companies`	List the companies that currently have live job postings on nicehire.ai, with the number of live postings per company.
`get_platform_overview`	Describe the NiceHire platform: its user roles, its mobile apps, and the current subscription plan names and prices read live from the pricing table.

Talent

Tool	What it does
`my_saved_jobs`	List the jobs you have saved on nicehire.ai, newest first, with each posting's public page URL. Paginated.
`my_applications`	List your own job applications on nicehire.ai with their current status, newest first. Paginated.
`my_job_recommendations`	List the active job recommendations generated for your profile, highest match score first, with each posting's public page URL. Paginated.

Employer (organization)

Employer tools require the account to be a member of at least one organization on NiceHire.

Tool	What it does
`my_job_postings`	List the job postings belonging to your organization(s) on nicehire.ai, including status and expiry, newest first. Paginated.
`applicants_for_job`	List the applications for one job posting in your organization, with each applicant's name, title, and application status. Paginated.

Mentor

Tool	What it does
`my_sessions`	List your own mentoring sessions on nicehire.ai with schedule, status, and payment state; filter by status or upcoming. Paginated.
`my_availability`	List your own mentoring availability windows (weekly slots and date-specific slots) as configured on nicehire.ai.

Access facts

Read-only: no tool inserts, updates, or deletes anything.
Role-scoped: the server resolves your roles from your token on the server side; tools/list only advertises what your account may call.
A token is required on every request; unauthenticated calls receive an authentication error.
Revocation takes effect on the next request: a revoked token is rejected.