API and MCP

Let your AI search for you

Members connect Claude, ChatGPT, Cursor or their own agent. It searches every senior role, reads the full posting, and hands you the direct apply link.

API keys come with membership

Connect Claude Code

claude mcp add --transport http boardroomlist https://boardroomlist.com/mcp \
  --header "Authorization: Bearer brl_YOUR_KEY"

Claude Desktop, Cursor, Windsurf

Add this to the app’s MCP settings file.

{
  "mcpServers": {
    "boardroomlist": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://boardroomlist.com/mcp",
        "--header", "Authorization: Bearer brl_YOUR_KEY"
      ]
    }
  }
}

What your agent can do

search_roles: Find open roles by keywords, seniority, function, work mode, region, pay floor and date.
get_role: Full description, scope, pay, locations and the direct apply link on the company site.
list_filters: The functions and seniority bands to search by, with how many roles are open.

REST API

Same data over plain HTTPS. Send your key as a Bearer token.

GET /api/v1/roles	Search roles. 25 a page.
GET /api/v1/roles/{id}	One role with description and apply_url.
GET /api/v1/filters	Functions and seniority bands with counts.

curl "https://boardroomlist.com/api/v1/roles?q=CFO&band=csuite&region=us" \
  -H "Authorization: Bearer brl_YOUR_KEY"

Search parameters

q: Keywords, e.g. CFO or VP supply chain
band: csuite, svp, vp, director, manager (comma list)
function: Finance, Technology, Operations... (comma list)
mode: onsite, hybrid, remote
region: us or intl
min_comp: Minimum posted salary, USD
posted_within_days: First seen in the last N days
top: Top N companies: 10, 25 or 50
status: open, new, today or filled
sort: senior, newest or comp
page: 1 and up

Limits

Keep your key secret. Send it only in the Authorization header, never in a URL.
If a key leaks, revoke it above. It stops working at once.
60 requests a minute and 5,000 a day. One key per account.
Keys work while your membership is active. They switch back on when you renew.
Errors come back as JSON: 401 bad key, 403 membership ended, 429 slow down.
For your own job search. Don’t resell or republish the listings.

Stuck connecting your agent? Contact us