Let job seekers search your board from AI assistants

Your board's own MCP server lets job seekers search your jobs and companies from Claude, ChatGPT, Cursor, and other AI assistants.

Every board on a paid plan has its own MCP (Model Context Protocol) server on the board's domain, at https://<your board domain>/mcp. Job seekers add that URL to Claude, ChatGPT, Cursor, VS Code, or any other assistant that supports remote MCP servers, then ask it to find jobs on your board. Every result links back to the job's page on your board, so candidates apply with you.

This is separate from Cavuno MCP, the server at mcp.cavuno.com that lets you and your team manage your board from an AI agent.

What job seekers get

  • A setup page at /mcp/docs on your board, with the server URL and copy-ready steps for Claude, ChatGPT, Claude Code, Cursor, and VS Code. On Cavuno hosting and on boards built with the AI website builder, your footer links to it as MCP.
  • No sign-up. The assistant reads what your board shows a visitor who is not signed in. Members-only jobs stay members-only.
  • Jobs that link home. Every job and company the assistant returns carries its page on your board.

What an assistant can do

The server is read-only. It can:

  • search_jobs: search your published jobs by keyword, location, category, remote option, and other filters
  • get_job: read one job in full, including salary, locations, remote options, and company
  • get_similar_jobs: list jobs similar to one job
  • list_categories and find_location: turn category and place names into the filters search_jobs takes
  • search_companies, get_company, and get_company_jobs: look up the companies hiring on your board and their open jobs
  • get_company_salaries: summarize a company's salaries, when your board shows salaries

You choose which of these tools your server offers: see Choose the tools. Nothing is saved or changed. Requests are rate limited per visitor and per board, and a limited request tells the assistant when to retry.

Turn it on or off

The board MCP server is on by default. To turn it off, open Settings → Integrations → Board MCP and switch off MCP server at the top of the card. Your board then answers /mcp and /mcp/docs with not found, and the MCP footer link goes away. While it is on, the same card shows your server URL to copy.

The server is also unavailable while password protection is on, and on the Free plan.

Choose the tools

Every tool is on by default. Under Tools on the same card, the tools are grouped into Jobs, Companies and Salaries:

  • Switch a single tool off to stop offering it. Assistants no longer see it, and your setup page at /mcp/docs no longer lists it.
  • Set a group's menu to On or Off to change every tool in it at once. The menu reads Custom when some of its tools are on and some are off.

Turning tools off keeps your choices if you later switch the whole server off and on again. The Salaries tool is only offered while your board shows salaries.

You can also set this with the API: send mcpDisabledTools, the list of tool names to leave out, to PATCH /v1/settings.

How assistants find it

Your board publishes an MCP Server Card at /mcp/server-card and lists it in an AI Catalog at /.well-known/ai-catalog.json, so assistants and directories that support MCP discovery can find the server from your domain alone.

Custom frontends

Boards built with the AI website builder serve the server and its setup page automatically. If you deploy your own frontend with the SDK, mount createMcpHandler from @cavuno/board/mcp at /mcp, /mcp/* and /.well-known/ai-catalog.json to serve the same server and setup page from your domain; the Cavuno starter template already does. Add your own link to /mcp/docs where you want one, and show it only while the board's features.mcp is true. Until your site answers /mcp/server-card, Settings → Integrations → Board MCP says the handler is missing.

Frequently asked questions