Connect Codex to Icypeas
Set up in minutes
Choose where it runs
On your computer through your own Codex, or hosted in the cloud. The rest of setup adapts to your choice:
Pick what it can do in Icypeas
A preset of real Icypeas operations. Each one becomes a tool the agent can call, and it can't touch anything outside the list.
Connect Icypeas
One sign-in. The agent acts through your account, scoped to the operations you picked.
Add your personal MCP link
The last step mints a private MCP URL for this agent and walks you through exactly this, with your real link filled in. The page flips to Connected the moment your Codex first calls in. Codex connects when a session starts — run codex, or restart a running one (in the Codex app, Restart).
Run this in your terminal. The Codex app shares its config, so it gets the server too
<your-link> is your personal server URL — setup mints it for you.
Tools Codex gets
Icypeas
15 toolsRead the connected account subscription and remaining credits (free).
Read a page of bulk search progress; pass the returned sorts explicitly.
Submit up to 5,000 rows. This starts a search and can spend credits.
Start an asynchronous domain search; read_results retrieves its result.
Start a professional email search; at least one name must be supplied.
Start an email verification search; this can spend credits.
Find a company's profile URL.
Find a person's profile URL.
Find up to 50 company or profile URLs in one request.
Read the first page or an exact single/bulk search. No implicit polling.
Look up the person behind one professional email address.
Look up people behind 2 to 50 professional email addresses.
Scrape one company page; returns an acknowledgement or result.
Scrape one profile; returns an acknowledgement or result.
Submit up to 50 company or profile pages for scraping.
About Codex
Frequently asked questions
More ways to connect
Open your Codex agent in one click.
NoClick runs Codex for you with Icypeas wired in as tools. Connect your account and run.