How to Use Built In job search in Codex
Returns matching job URLs and company slugs from Built In's public job listings. Use it to discover roles by keyword, then read the job and company records for context.
Prompts to try with Built In job search in Codex
Copy an example into Codex, or ask in your own words.
Use Built In job search to find analytics engineer roles, then add the returned job URLs and company slugs to this project's research dataset.
Use Built In job search for Kubernetes and create a review table in this project linking each returned role to its employer.
Use Built In job search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Built In job search and tell me what changed since last week.
Check Built In job search and summarize what you find in three bullet points.
How to set up Built In job search in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Built In job search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "builtin-com/jobs/search", "input": { "page": 1 } }'
Then paste one of the prompts above: Codex finds Built In job search on Spiral, shows the price and runs it.
Built In job search providers and prices
Spiral runs Built In job search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | 1 to 100 | 1 | page |
Every API field of Built In · Search is on its tool page: open its card above.
What can you do with Built In job search in Codex?
Build an employer comparison in your project using Built In job listings and company profiles. Turn descriptions, published requirements, and employer context into searchable records for a recruiting or career research tool.
Build an employer shortlist
Find Python roles, read the requirements, and add each employer's business description and listed employee count to a comparison.
Prepare for an interview
Find a Datadog opening, examine its responsibilities, and use the company profile to draft questions about the business and the role.
Research potential recruiting clients
Find employers advertising data engineering roles, review the hiring requirements, and organize the companies by their listed industries and employee counts.
Plan a career event
Find entry-level opportunities, check the descriptions for experience requirements, and assemble employer briefs for a university career team.
Study demand for a technical skill
Search for Kubernetes roles, read how employers describe the work, and compare the business types behind the listings.
Compare competing employers
Find roles at Datadog and Dynatrace, compare the published responsibilities and compensation where available, and add company descriptions for context.
More on Built In job search and Codex
Overview
Built In job search in other agents
Questions about Built In job search in Codex
Can Codex use Built In job search?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Built In job search like any built-in tool.
How much does Built In job search cost in Codex?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need an Alexandria account to use Built In job search in Codex?
No. Spiral runs Built In job search on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Built In job search in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Built In job search runs?
Built In job search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.
How broad is Built In's company coverage?
Built In says it has more than 100,000 company profiles. That figure describes its company directory, not the number of employers currently advertising jobs.
Does Built In cover employers outside the United States?
Yes. Built In describes its technology and startup job coverage as global, and its job directory links to markets including Canada, India, Australia, and Singapore.
How often does Built In receive new job data?
Built In says new jobs are added daily and schedules a daily sync for employer job integrations. This is a publishing schedule, so it does not establish that every listing reflects an employer's status at this moment.
Who supplies the company descriptions and job listings?
Companies can supply their own workplace descriptions and job listings. Built In distinguishes that employer-provided material from its independent reporting and analysis.
Is Built In limited to software engineering roles?
No. Its public listings include sales work, such as a Coach Sales Associate III role, alongside engineering jobs.
Start using Built In job search in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


