Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http mcp-server https://mcp.youricp.com/sse
Open on GitHub

What 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/sse

2Platform CLI

claude mcp add --env YOURICP_API_TOKEN=<YOURICP_API_TOKEN> --env YOURICP_API_URL=<YOURICP_API_URL> --transport stdio youricp -- npx -y @youricp/mcp

Replace <…> 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.

Similar MCP servers

All MCP servers for Marketing and content →

Project sponsors

Companies that keep this analytics open