# YourICP

YourICP enriches contacts from an email address or LinkedIn URL and assembles targeted B2B audiences. Called straight from a conversation with the assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: YourICP
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/YourICP/mcp-server
- Updated: 2026-10-07
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/youricp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.youricp.com/sse`
- Environment variables: `YOURICP_API_TOKEN`, `YOURICP_API_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://mcp.youricp.com/sse
```

2. **Platform CLI**
```bash
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

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add youricp --url https://mcp.youricp.com/sse
```

2. **Platform CLI**
```bash
codex mcp add youricp --env YOURICP_API_TOKEN=<YOURICP_API_TOKEN> --env YOURICP_API_URL=<YOURICP_API_URL> -- npx -y @youricp/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "youricp": {
            "url": "https://mcp.youricp.com/sse"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "youricp": {
            "type": "http",
            "url": "https://mcp.youricp.com/sse"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http youricp https://mcp.youricp.com/sse
```

2. **Platform CLI**
```bash
gemini mcp add -e YOURICP_API_TOKEN=<YOURICP_API_TOKEN> -e YOURICP_API_URL=<YOURICP_API_URL> youricp npx -y @youricp/mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [prospeo-mcp-server](https://affpapa.org/en/nevibecode/mcp/prospeo-mcp-server.md) — MCP server
- [cargo-gtm](https://affpapa.org/en/nevibecode/skills/cargo-gtm.md) — skill · 11600 installs
- [prospecting](https://affpapa.org/en/nevibecode/skills/prospecting.md) — skill · 77400 installs
- [LinkedIn Automation](https://affpapa.org/en/nevibecode/skills/linkedin-automation.md) — skill · 5400 installs
- [Scripe](https://affpapa.org/en/nevibecode/mcp/scripe.md) — MCP server · ★ 1 repo stars
- [GTM Otto](https://affpapa.org/en/nevibecode/mcp/gtm-otto.md) — MCP server · ★ 1 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
