When you source candidates from Claude Code as a recruiter or company team, Get on Board’s MCP server connects your Claude Code session to Talent Database so you can search Latin American tech professionals without leaving the CLI.
You can also give this whole page to your agent and ask it to install the server for you. The agent can follow the setup steps and run the CLI command, and you can complete the browser authorization when Get on Board opens the OAuth flow.
This guide covers the supported Claude Code setup path only.
Before you start
You need:
- Claude Code installed and signed in on your machine.
- A Get on Board recruiter account with access to an accepted company.
- The remote MCP server URL:
https://www.getonbrd.com/mcp.
Add the server in Claude Code
Open a terminal in any project directory and run:
claude mcp add --transport http getonbrd https://www.getonbrd.com/mcp
Claude Code stores the server locally, but OAuth does not happen yet.
Confirm the server was added
Run:
claude mcp list
You should see getonbrd in the list. If the CLI shows Failed to connect at this stage, that is expected. Claude Code is checking the server before you have authorized it.
Restart Claude Code
Start a new Claude Code session after adding the server. The MCP client loads newly added servers only when the session starts.
Authorize Get on Board
On the first real Get on Board tool call after the restart, Claude Code opens the OAuth authorization flow in your browser. Then:
- Sign in to Get on Board with your recruiter account.
- Select the company context Claude Code should use.
- Approve the requested MCP access.
After authorization, the Get on Board tools are available in Claude Code.
Verify the connection
In Claude Code, ask:
Use the Get on Board MCP server to call whoami and confirm my active company.
Claude Code should return your Get on Board identity, the active company context, and the available MCP tools.
Then try a Talent Database search, for example:
Use Get on Board to find senior Python engineers in Mexico with English C1 who are available soon.
What Claude Code can do with this server
See the Get on Board MCP Server overview for the full tool reference and example workflows.
If you need to reconnect
Run:
claude mcp remove getonbrd
claude mcp add --transport http getonbrd https://www.getonbrd.com/mcp
Then start a new Claude Code session and authorize Get on Board again on first use.
If Claude Code does not show the Get on Board tools immediately after authorization, start another new Claude Code session.
Troubleshooting
Why did the Get on Board tools disappear?
Get on Board’s MCP access tokens last 2 hours, and the server does not issue a refresh token. When your token expires, Claude Code loses access to the Get on Board tools until you authorize again. Follow “If you need to reconnect” above — expect this to happen periodically during a long session, it is not a bug. If authorizing again does not bring the tools back, wait a few minutes before you retry — several attempts in a row can hit our rate limits.
Run whoami first
Whenever you are not sure the connection is working, ask Claude Code to call whoami before anything else. It confirms your Get on Board identity, active company, granted scopes, and available tools, and it needs the least access of any tool to run. If whoami is the only tool Claude Code lists, your current authorization only grants the baseline “Confirm your Get on Board identity” permission — see the Talent Database permission below.
Use the exact server URL
Enter https://www.getonbrd.com/mcp exactly, matching “Before you start” above. A typo in the domain or the path sends your client to a server that is not ours, and the connection fails before OAuth starts.
Candidate search needs the Talent Database permission
The Talent Database search tool appears only when your authorization granted the “Search professionals in Talent Database” permission. The authorization screen lists the permissions your client asked for — you cannot add one there. So if whoami does not list that permission, remove the Get on Board connection in Claude Code and add it again, so it registers from scratch and asks for the permission.
Related articles
- What is the Get on Board MCP Server?
- How can I use Get on Board for agentic recruitment?
- How to set up Get on Board’s MCP server with Codex
- How to set up Get on Board’s MCP server with ChatGPT
- What is Talent Database?
- Can I directly access the contact data in the Talent Database?
- What can I do with Get on Board’s API?
More from Integrations and developer tools
Sign in with Google
