Argorant Help
EN|DEargorant.comOpen Argorant
Help/AI agents & API

Set up Argorant in Codex

Published by Argorant

Connect Codex to Argorant with two terminal commands or the Codex MCP settings, sign in once, check it works with /mcp, and know how to remove it again.

Codex is OpenAI's coding agent. It runs in a terminal, in your editor and as a desktop app. Once Argorant is connected, you can ask Codex for market counts, contact lists, exports and campaigns in plain words, next to your code, and it uses your Argorant account and credits.

There are two ways in. The MCP connection is the one we recommend: Codex signs in to Argorant in your browser and gets Argorant's tools. The setup prompt is a shortcut for people who prefer an API key: you paste one prompt and Codex sets up the Argorant command line for itself.

Before you start

  • You need an Argorant account with a confirmed email. No account yet? You can create one during the sign-in step.
  • Run Codex on your own computer (the terminal app, the editor extension or the desktop app). A hosted Codex web task does not read your local MCP settings, so use the connection that task offers instead.
  • In Argorant, open AI connections in the sidebar and pick the Codex tab. It shows the exact commands for your account.

Connect with the MCP commands (recommended)

  1. On the Codex tab, click Use AI connection settings. The tab first shows the setup prompt; this button switches to the MCP commands.
  2. Click Copy setup to copy both commands.
  3. Run them in a terminal on the same computer where Codex runs.
codex mcp add argorant --url https://mcp.argorant.com/mcp
codex mcp login argorant
  1. The first command saves Argorant as an MCP server called argorant. The second one opens your browser for the sign-in.
  2. Sign in to Argorant. You see Argorant's permission screen. For Codex it usually says Connect Argorant to an app on this computer with a yellow note that Argorant cannot check the app. That is normal for apps that sign in through your own computer. If you just ran the command yourself, click Allow access.
  3. Go back to the terminal. Codex confirms the login.
The Codex tab on the AI connections page with the two MCP commands and the Copy setup button
After Use AI connection settings, the Codex tab shows the two commands. Copy setup copies both.

Prefer clicking? In the Codex desktop app or the editor extension, open Settings, then MCP servers, then Add server. Choose Streamable HTTP, name it argorant and enter https://mcp.argorant.com/mcp. Then select Authenticate and finish the same browser sign-in. The terminal commands and the settings write the same entry, so use one or the other, not both.

The Argorant permission screen as Codex users see it, with the note that Argorant cannot check the app and the Allow access button
The permission screen for Codex. The list shows what the connection can do; Allow access approves it.

Check that it works

  1. Restart Codex, or start a new session, so it loads the new server.
  2. Type /mcp in Codex. Argorant should be listed with its tools. In a plain terminal, codex mcp list shows the saved servers too.
  3. Start a new task with the request Check my Argorant account. Codex calls argorant_account and answers with your email, your role and the credits left.

Only that real answer proves the connection. A message like "connected" without your account details is not proof. On the Argorant side, the app now shows up under Settings, AI connections, Connected apps.

The setup prompt path

If you would rather work with an API key and the Argorant command line, stay on the first view of the Codex tab.

  1. Click Create private key. Argorant creates a personal key for this setup.
  2. Click Copy setup prompt. The prompt contains your new key, so paste it only into your own Codex session.
  3. Codex checks your account with the key, sets up npx argorant and tells you when it is connected.
The Codex tab showing the setup prompt path with Create private key and Copy setup prompt, and the button that switches to the MCP commands
The Codex tab opens on the setup prompt path. Use AI connection settings (1) switches to the MCP commands.

The key path works well, but the command line spends credits without asking when it runs inside an agent. Read the guardrails article before you let Codex run exports on its own.

Prompts to try

Check my Argorant account and tell me how many credits I have left.

Free. Codex calls the account tool and reports.

Count CTOs at software companies in the Netherlands with 50 to 200 employees. Show five examples with names hidden.

Free. Codex counts and previews, then suggests next steps.

Save that search as a list called NL CTOs. Do not reveal or export anything.

Free. Codex saves the list and gives you the link to Lists.

Export the NL CTOs list to CSV. Tell me the row count and the most it can cost first, then wait for my yes.

Codex states the cost and waits. After your yes it starts the export and checks it until the file is ready under Exports.

Common mistakes

  • Running the commands on another machine. The MCP entry lives where you ran codex mcp add. If Codex runs in a container or on a server, run the commands there.
  • Skipping codex mcp login argorant. Without it the server is saved but not signed in, and Codex reports that it needs authentication.
  • Adding Argorant twice under different names. Keep one entry. If you already have one, log in again instead of adding another.
  • Expecting mailbox orders in Codex. OpenAI apps do not get those tools. Do them in the Argorant app.
  • Pasting the private setup prompt into a shared chat or a repository. It contains your key. If that happens, delete the key under Settings, API keys.

Remove Argorant from Codex

  1. Run codex mcp logout argorant to drop the sign-in, then codex mcp remove argorant to delete the entry. In the app or editor, remove it under Settings, MCP servers.
  2. In Argorant, open Settings, AI connections and click Disconnect next to the app under Connected apps. Access ends at once.
  3. If you used the setup prompt, also delete that key under Settings, API keys.

Your lists, exports and campaigns stay in your Argorant account either way. Codex works on the same account as the web app, so everything it makes is there for you to check.

Related
MCP tools, scopes and spending safetySpending guardrails: instructions that keep an agent cheapMCP connection and scope errorsThe setup prompt

Still stuck? support@argorant.com

Help homeargorant.comPricingRoadmap
support@argorant.com
1
Run these commands
TTerminal
$codex mcp add argorant --url https://mcp.argorant.com/mcp
$codex mcp login argorant

Illustration. Your screen may look a little different.

Run them where Codex runs. Or add the server in Codex under Settings, then MCP servers.
codex mcp add argorant --url https://mcp.argorant.com/mcp codex mcp login argorant
2
Sign in and allow access
Argorant

Connect Argorant to an app on this computer

  • See how many people and companies match a search
  • Preview matching people and companies, with contact details hidden
  • Save lead lists and add people to them
Allow access

Illustration. Your screen may look a little different.

The second command opens the browser. Sign in and click Allow access.
3
Ask for your first matches
TTerminal
$/mcp
$Check my Argorant account

Illustration. Your screen may look a little different.

Check /mcp in Codex, then start a new task. The prompt on the last screen is a good start.