Codex CLI

Valency Bond™ works with the Codex CLI (opens in new tab) over MCP using OAuth. Installing the Valency plugin brings the MCP connection and the research skills in one step.

1. Add the Valency marketplace, install the plugin, and sign in with one chained command:

   codex plugin marketplace add valency-oss/valency-connectors && \
     codex plugin add valency@valency && \
     codex mcp login valency

   The plugin carries both the Valency Bond MCP connection and the research skills, so there's no separate MCP server to add and no separate Valency app to install. codex mcp login authorizes the bundled connection.

   Complete sign-in when the browser opens, then return to the terminal.

   Note

   A Valency account is created automatically the first time you sign in. The email you use does not have to match the email on your ChatGPT account.

2. Start a new Codex session so its skills and MCP tools load:

   codex

3. Verify the connection. Run /mcp inside Codex. Valency is listed with its tools.

4. Ask (more prompt ideas):

   Use Valency to search for papers about quantum computing

You're connected

You see paper results in your terminal. You can also explicitly invoke Valency tool calls.

Skills

The plugin also installs a set of multi-step research workflows on top of the MCP tools. Each one is a prescribed chain of tool calls, not a single search.

Skill	Ask things like
profile	"Who is Yoshua Bengio and what do they work on?"
landscape	"Give me a landscape of cs.LG"
similar	"Find papers similar to arXiv 1706.03762"
trends	"Is diffusion model research still growing?"
network	"Who does Yann LeCun collaborate with?"
reading-list	"What should a student of geometric deep learning be reading?"
fresh-collaborators	"Who should this researcher be talking to that they aren't already?"

Trigger a skill by slash command or natural language:

Codex CLI

/valency:profile Yoshua Bengio
What should David Hogg be reading next?

Troubleshooting

Need to sign in again? After a token expires, or if you clear credentials:

codex mcp login valency

Skills or tools don't appear? Start a new Codex session. Plugins load at session start, not mid-session.

Need to start over? Remove the plugin and its marketplace, then reinstall:

codex plugin remove valency@valency && \
  codex plugin marketplace remove valency

The marketplace is registered under the name valency, even though you added it using the source valency-oss/valency-connectors.

---

Need help?

If something isn't working, check Troubleshooting for common fixes. See the FAQ for general questions, or report an issue if you're still stuck.