When you want an AI agent to help source candidates, the Get on Board MCP Server connects your recruiter tools to Get on Board’s Talent Database. Search tech candidates in Latin America and find the best match for your open positions — straight from a brief, or, if you’ve already posted the role on Get on Board, by pointing your agent at it.
What an MCP server is
MCP means Model Context Protocol. An MCP server gives an AI client a controlled way to use external tools and data sources. Instead of copying data into a chat or building a custom integration for every agent, you connect the agent to a server that exposes specific actions.
For recruiting, that means your AI client can ask Get on Board for candidate search results through approved tools. The client does not receive broad database access, passwords, API keys, or unrestricted profile data.
How Get on Board’s MCP Server works
Get on Board’s MCP Server is a remote, OAuth-authenticated server at https://www.getonbrd.com/mcp. You paste that URL into a compatible MCP client, sign in to Get on Board in the browser, choose the company context you want to authorize, and approve the requested access.
The server currently exposes five recruiter tools:
whoami: confirms your Get on Board identity, active company, granted scopes, and available tools.search_talent: searches Talent Database from a natural-language brief of the ideal candidate. This is the core tool — you can call it directly with any brief.talent_profile: reads one candidate in depth. Pass the candidate id thatsearch_talentreturned, and you get that person’s profile description, professional and academic background, skills, tags, and quiz traits. The candidate’s name comes back only when your company already unlocked that profile or the person applied to one of your jobs.list_jobs(optional): lists your active hiring processes in the authorized company.job_details(optional): returns the full description and application questionnaire for one of your job postings. Useful when you want to source for a specific role without re-typing the brief.
list_jobs and job_details only return jobs that belong to the authorized company. The server is designed for recruiter team members with accepted company access. search_talent and talent_profile share one permission and both appear as soon as you approve Talent Database access on the consent screen — there is no separate company entitlement or plan to buy first. Searching works from there; reading a full profile with talent_profile also needs an active subscription — without one the candidate comes back as not found. Profile reads are capped at 30 per hour, so point your agent at the candidates worth a closer look instead of every result.
What you can do with it
Use the MCP Server when you want your agent to help with candidate discovery:
- Search for professionals by role, stack, seniority, country, English level, salary range, industry background, or other criteria you describe in plain text.
- Optionally point your agent at one of your open jobs in Get on Board so it can read the description and application questionnaire and feed that into the search automatically.
- Ask your agent to refine a search, compare returned profiles, or build a shortlist from the safe candidate summaries.
- Read a candidate in full without leaving your agent: background, skills, tags, and quiz traits for anyone in the results, so you can rank a shortlist before you open a single profile in the web app.
- Open Get on Board profile links to review full details in the web app.
The MCP Server returns profile links and safe summaries. Contact details, CV files, WhatsApp, and social URLs are not returned through MCP — open the profile in Get on Board to unlock contact information with credits, invite a candidate to a process, or continue the hiring workflow.
Supported clients
The same remote server URL can work with any compatible MCP client that supports remote servers with OAuth. Get on Board has setup guides for:
Troubleshooting
Why did my tools disappear, or never show up?
Get on Board’s MCP access tokens last 2 hours, and the server does not issue a refresh token yet, so your client loses access to the tools when the token expires — you need to authorize again. This is expected, not a bug, and it can happen more than once in a long session. Each setup guide above has an “If you need to reconnect” section with the exact steps for that client. 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 unsure a connection works, call whoami before anything else. It needs the least access of any tool and confirms your Get on Board identity, active company, granted scopes, and available tools. If whoami is the only tool your client lists, your current authorization only grants the baseline “Confirm your Get on Board identity” permission — Talent Database search was not included.
Use the exact server URL
Enter https://www.getonbrd.com/mcp exactly, as documented above and in each setup guide. 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 tools — search_talent and talent_profile — appear 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. Without that permission your client still connects and whoami still works, but candidate search and profile reads stay out of the tool list. Remove the Get on Board connection in your client and add it again, so it registers from scratch and asks for the permission.
Related articles
- How can I use Get on Board for agentic recruitment?
- What is Talent Database?
- How to set up Get on Board’s MCP server with ChatGPT
- How to set up Get on Board’s MCP server with Codex
- How to set up Get on Board’s MCP server with Claude Code
- How to set up Get on Board’s MCP server with Cursor
- Tools to reach tech candidates in Latin America: enrichment, scraping or marketplace?
More from Integrations and developer tools
Sign in with Google
