Claude Code

For developers using the CLI. As of v2.1.162 · June 2026

Prerequisite

You need a Valency account. Sign up here if you haven’t already.

1. Open your terminal

2. Add the Valency MCP server:

   claude mcp add --transport http \
     --client-id FslW0nVE1JMNobe1wQEsTr7bIwhZTi89 \
     --callback-port 33418 \
     valency-mcp https://labs.valency.io/mcp

   Note

   The --client-id flag is required. Our Auth0 tenant doesn’t expose RFC 7591 Dynamic Client Registration. The --callback-port flag pins the OAuth redirect to a port whitelisted in Auth0; without it, Claude Code picks an ephemeral port and the callback will be rejected.

3. Start Claude Code:

   claude

4. Authenticate the server. Adding it from the command line does not start the OAuth flow on its own — run the /mcp command inside Claude Code, select the Valency MCP server, and choose to authenticate:

   /mcp

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

5. Ask: “Search for papers about quantum computing”

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

Next steps

Install Valency skills

The Valency plugin layers seven multi-step research workflows on top of the MCP tools — profile, landscape, similar, trends, network, reading-list, and fresh-collaborators. Each one is a prescribed chain of tool calls, not a single search.

From your terminal:

claude plugin marketplace add valency-oss/valency-claude-plugin && claude plugin install valency

Restart Claude Code, then trigger a skill by slash command or natural language:

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

---

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.