How to set up Get on Board's MCP server with Codex

When you source candidates from Codex as a recruiter or company team, Get on Board’s MCP server connects Codex to Talent Database so you can search Latin American tech professionals from your Codex session.

Use the CLI setup path first. Codex stores MCP configuration in a shared config file, so the server you add from the terminal is also available in the Codex app.

Before you start

You need:

  • Codex installed and signed in.
  • A Get on Board recruiter account with access to an accepted company.
  • Talent Database access on the company account you will authorize.
  • The remote MCP server URL: https://www.getonbrd.com/mcp.

Add the server from the Codex CLI

Open a terminal and run:

codex mcp add getonbrd --url https://www.getonbrd.com/mcp
codex mcp login getonbrd

The first command creates a Streamable HTTP MCP server named getonbrd. The second command opens the OAuth authorization flow in your browser.

When the browser opens:

  1. Sign in to Get on Board with your recruiter account.
  2. Select the company context Codex should use.
  3. Approve the requested MCP access.

After authorization, restart the Codex app or open a new Codex session so the tools are loaded.

Verify the connection

In Codex, ask:

Use the Get on Board MCP server to call whoami and confirm my active company.

Codex 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.

Optional: edit config.toml directly

If you prefer to edit Codex configuration yourself, add only the server URL:

[mcp_servers.getonbrd]
url = "https://www.getonbrd.com/mcp"

Then run:

codex mcp login getonbrd

Do not add an API key, client ID, client secret, or custom transport field. Codex and Get on Board complete Dynamic Client Registration and OAuth automatically in the browser.

What Codex can do with this server

The server gives Codex two MCP tools:

  • whoami: confirms your Get on Board identity, active company, granted scopes, and available tools.
  • search_talent: runs a Talent Database search using role, stack, location, seniority, English level, salary, and other recruiting criteria.

Codex receives safe candidate summaries and Get on Board profile links. Contact details, CV files, WhatsApp, and social URLs are not returned through MCP. Unlocking contact information, spending credits, sending invitations, and continuing the hiring workflow still happen in Get on Board.

If you need to reconnect

Use the same server name you chose when adding it. If you used getonbrd, you can reconnect with:

codex mcp logout getonbrd
codex mcp remove getonbrd
codex mcp add getonbrd --url https://www.getonbrd.com/mcp
codex mcp login getonbrd

If Codex does not show the Get on Board tools immediately after login, start a new Codex session or restart the Codex app.

Related articles

More from Integrations and developer tools