YourICP — Claude Code MCP server: what it does, how to install
YourICP enriches contacts from an email address or LinkedIn URL and assembles targeted B2B audiences. Called straight from a conversation with the assistant.
MIT updated 2026-10-07
claude mcp add --transport http mcp-server https://mcp.youricp.com/sseWhat YourICP does
The server exposes two pairs of tools: set_auth_token (with the deprecated set_token alias) for authentication, and submit_lookup plus check_lookup for starting a contact lookup and retrieving its result by jobId. A request gets queued and the answer comes back on polling, so this runs as an async job rather than a single instant call.
There are two ways to connect it. The hosted endpoint at https://mcp.youricp.com/sse uses OAuth and unlocks both tool groups, audience building included. Running the package locally via npx @youricp/mcp only covers contact enrichment and needs your own token set in YOURICP_AUTH_TOKEN (the older YOURICP_API_TOKEN name still works but is flagged as deprecated).
Local mode needs Node.js 18 or newer. The maintainers describe this codebase as a small reference implementation with no payment or OAuth layer built in, so it never touches YourICP's billing tokens, the separate prepaid currency used for paid enrichment work.
What it helps with
- enrich a batch of email addresses with contact data
- look up a person's details from a LinkedIn URL
- assemble a targeted B2B audience matching a customer profile
- retrieve an async enrichment result by job ID
- add enrichment tools to an agent without a local install
Example prompts for the agent
- Enrich this list of emails with YourICP and show me the result for the jobId
- Look up this LinkedIn profile through YourICP
- Build a B2B audience matching this customer profile using YourICP
How to install YourICP
1Platform CLI: remote server
claude mcp add --transport http mcp-server https://mcp.youricp.com/sse2Platform CLI
claude mcp add --env YOURICP_API_TOKEN=<YOURICP_API_TOKEN> --env YOURICP_API_URL=<YOURICP_API_URL> --transport stdio youricp -- npx -y @youricp/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add youricp --url https://mcp.youricp.com/sse2Platform CLI
codex mcp add youricp --env YOURICP_API_TOKEN=<YOURICP_API_TOKEN> --env YOURICP_API_URL=<YOURICP_API_URL> -- npx -y @youricp/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"youricp": {
"url": "https://mcp.youricp.com/sse"
}
}
}{
"mcpServers": {
"youricp": {
"command": "npx",
"args": [
"-y",
"@youricp/mcp"
],
"env": {
"YOURICP_API_TOKEN": "<YOURICP_API_TOKEN>",
"YOURICP_API_URL": "<YOURICP_API_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"youricp": {
"type": "http",
"url": "https://mcp.youricp.com/sse"
}
}
}{
"servers": {
"youricp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@youricp/mcp"
],
"env": {
"YOURICP_API_TOKEN": "<YOURICP_API_TOKEN>",
"YOURICP_API_URL": "<YOURICP_API_URL>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http youricp https://mcp.youricp.com/sse2Platform CLI
gemini mcp add -e YOURICP_API_TOKEN=<YOURICP_API_TOKEN> -e YOURICP_API_URL=<YOURICP_API_URL> youricp npx -y @youricp/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about YourICP
How do I install the YourICP MCP server in Claude Code?
For the hosted version: claude mcp add --transport http mcp-server https://mcp.youricp.com/sse. For a local run: claude mcp add --env YOURICP_API_TOKEN=<YOURICP_API_TOKEN> --env YOURICP_API_URL=<YOURICP_API_URL> --transport stdio youricp -- npx -y @youricp/mcp.
What does the YourICP MCP server do?
It enriches contacts from an email address or LinkedIn URL and builds targeted B2B audiences, routing requests to the YourICP API from inside an AI assistant conversation.
How does local mode differ from the hosted connector?
The hosted connector at https://mcp.youricp.com/sse uses OAuth and includes audience building, while running npx @youricp/mcp locally needs your own token in YOURICP_AUTH_TOKEN, Node.js 18 or newer, and only covers contact enrichment.