# The Best Job Board

> A salary-first U.S. job board indexing 1.5M+ active openings from
> corporate career sites (Workday, Greenhouse, Lever, custom ATSes).
> Exposes its full index to AI agents via the Model Context Protocol
> (MCP) so an agent can search, filter, and surface jobs on the user's
> behalf.

The Best Job Board is built for the AI-agent era: users connect their
AI assistant (Claude Desktop, Cursor, any MCP-compatible client) to
TBJB and search the index directly from inside their chat workflow.
Free accounts see listings 7+ days old; subscribers ($8/mo, 14-day
free trial) see day-0 listings the moment they're posted.

## MCP server

- Endpoint: https://www.thebestjobboard.com/api/v2/mcp
- Transport: Streamable HTTP, JSON-RPC 2.0
- Auth: `Authorization: Bearer <token>`
- Get a token: https://www.thebestjobboard.com/dashboard/mcp
- Setup docs: https://www.thebestjobboard.com/mcp

## Tools

### search_jobs

Free-text + filter search across the full index.

Parameters:
- `query` (string): free-text search. Supports `-word` exclusions
  (e.g. "python -recruiter").
- `industry` (string[]): industry slugs. Multi-select OR. Examples:
  `software_tech`, `banking_finance`, `healthcare`, `retail_consumer`.
- `function` (string[]): function slugs. Examples: `engineering`,
  `sales`, `marketing`, `finance`, `operations`.
- `location` (string): city / state / ZIP substring (e.g. "Boston",
  "94103", "Bay Area"). Case-insensitive substring match on each
  job's location text.
- `remote` (bool): `true` = remote-only.
- `salary_min`, `salary_max` (number): annual compensation, USD.
- `us_only` (bool): defaults to `true`. Pass `false` to include
  worldwide jobs.
- `employment_type` (string[]): e.g. `Full-Time`, `Contract`,
  `Internship`, `Part-Time`.
- `experience_level` (string[]): YOE bins `0-2`, `3-5`, `6-10`, `10+`.
- `page` (int, default 1), `limit` (int, default 25, max 100).

Returns a prose listing with title, company, location, salary,
posted-relative timestamp, status (locked or unlocked), and either
the apply URL (unlocked) or a subscribe prompt (locked).

### get_job

Full details for one listing by slug.

Parameters:
- `slug` (string): the slug returned by `search_jobs`.

Returns title, company, location, salary, employment type, posted
date, apply URL (if unlocked), and the full job description.

## Rate limits and acceptable use

- Each MCP token is limited to 1,000 calls/day. Resets at 00:00 UTC.
- Tokens whose call pattern looks like bulk extraction (many
  filter-less search calls, or unusually deep pagination) are
  auto-revoked. This is intentional — TBJB is for end-user job
  search, not data harvesting.
- Bulk extraction, redistribution, and use of TBJB data to train or
  feed competing products are prohibited under our Terms of Service:
  https://www.thebestjobboard.com/terms
- For commercial / B2B / high-volume use cases (recruiter tooling,
  staffing platforms), email support@thebestjobboard.com for a
  separate API tier.

## Recency paywall

Every listing has an `is_locked` flag. Free users get `is_locked:
true` on listings under 7 days old, with company name and apply URL
hidden. Subscribers see every listing the day it's posted. The
paywall applies identically through MCP — the user's subscription
status determines what their agent sees.

## Apply flow

Each unlocked listing returns an `apply_url` pointing to the
employer's ATS or careers page (Workday, Greenhouse, Lever, custom
flows). Agents with browser automation (Claude Computer Use,
OpenAI Operator, browser-use, Playwright-driven flows) can drive
those forms directly. TBJB does not currently host a server-side
auto-apply tool — that may ship as `apply_via_tbjb` in a future
MCP version.

## Related resources

- Homepage: https://www.thebestjobboard.com/
- Job listings: https://www.thebestjobboard.com/jobs
- Companies index (16K+ employers): https://www.thebestjobboard.com/companies
- Career Insights — original data analyses on U.S. hiring:
  https://www.thebestjobboard.com/insights
- Sitemap index: https://www.thebestjobboard.com/sitemaps/sitemap-indexes.xml
- Pricing & subscription: https://www.thebestjobboard.com/dashboard/subscriptions
- Influencer referral program ($5 per verified paid signup):
  https://www.thebestjobboard.com/referrals

## Contact

- Support: support@thebestjobboard.com
- Issues / feedback: file via the contact form on the homepage