YourICP
概要
作者による説明(英語の原文)
Enrich contacts by email or LinkedIn URL and build targeted B2B audiences.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi3項目中3項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況iとても新しい↓ 49/週 · ★ –
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンでもクラウドでも
- トランスポート: stdio, Streamable HTTP
- カテゴリ: マーケティング・SNS
- 入力が必要なもの:YOURICP_API_TOKEN
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:3項目中3項目に合格
- 作者のサーバーで動きます。あなたが頼んだ内容は、作者のサーバーを通ります。
- できること:13件(ツール) set_auth_token, set_token, activate_login, submit_lookup …
- 自分で入力するもの:
YOURICP_API_TOKEN,YOURICP_API_URL
「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
ウェブ、デスクトップ、モバイルのClaudeで使えます:
- Settings → Connectors を開く
- Add custom connector を押す
- 下のアドレスを貼り付けて Add を押す
- サインインを求められたら、作者のサービスにサインインする
https://mcp.youricp.com/sseまたは、パソコンで動かす
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"youricp": {
"command": "npx",
"args": [
"-y",
"@youricp/mcp"
],
"env": {
"YOURICP_API_TOKEN": "your-value",
"YOURICP_API_URL": "your-value"
}
}
}
}ターミナルでこれを実行します
claude mcp add --transport http youricp https://mcp.youricp.com/sseまたは、パソコンで動かす
claude mcp add youricp --env YOURICP_API_TOKEN=your-value --env YOURICP_API_URL=your-value -- npx -y @youricp/mcp動かす前に、空欄の値を入力してください。
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"youricp": {
"url": "https://mcp.youricp.com/sse"
}
}
}または、パソコンで動かす
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"youricp": {
"command": "npx",
"args": [
"-y",
"@youricp/mcp"
],
"env": {
"YOURICP_API_TOKEN": "your-value",
"YOURICP_API_URL": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"youricp": {
"type": "http",
"url": "https://mcp.youricp.com/sse"
}
}
}または、パソコンで動かす
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"youricp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@youricp/mcp"
],
"env": {
"YOURICP_API_TOKEN": "your-value",
"YOURICP_API_URL": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
ChatGPTがつなげるのは、インターネット上のサーバーだけです:
- ウェブ版のChatGPTを開き → Settings → Connectors (Apps)
- Create または Add を押す(プランによっては、先に Advanced で Developer mode をオンにする必要があります)
- 下のアドレスを貼り付け、名前を付けて保存する
- サインインを求められたら、作者のサービスにサインインする
https://mcp.youricp.com/sseメニューの名前は、プランや時期によって少し違うことがあります。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
自分で入力する値
- Your YourICP API token. Get one at https://app.youricp.com
YOURICP_API_URLenvBase URL of the YourICP API (defaults to https://app.youricp.com)
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
ツールの名前と説明は、サーバーが2026年11月9日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。
set_auth_tokenSet the user's YourICP auth token for this session. Call this when the user pastes their auth token in the chat. This is an API credential, NOT YourICP billing tokens — billing tokens are the prepaid currency a run spends, and check_billing_balance reads them. Once set, the auth
set_tokenDEPRECATED — call set_auth_token instead. Sets the user's YourICP auth token for this session.
activate_loginActivate a login completed in the browser. Call this after signing in at the login page. Automatically retrieves the auth token and activates it for this session — no copy/paste needed.
submit_lookupSubmit a contact enrichment job for one or more email addresses or LinkedIn profile URLs. Provide emails, linkedInUrls, or both. Set phoneValidation to true to also confirm each phone number with a live phone call; it raises the price per contact from $0.02 to $0.19. If logged in
check_lookupCheck the result of a previously submitted contact enrichment job by jobId. Polls every 5 seconds until the job is complete (max 2 minutes). Returns enriched contact data or an error message.
check_paymentCheck whether a Stripe checkout session has been paid and execute the next step. Call this after presenting the checkoutUrl to the user. If status is "pending", wait a few seconds and call again. - If called after submit_lookup: once status is "done" call check_lookup with the re
audience_startEntry point for all audience-building workflows. Always call this first when the user wants to find contacts, build an audience, or get a contact list. This tool decides which options to offer based on the connected client: clients that can render the interactive filter widget (e
audience_get_filtersFetch all available audience filter categories as an interactive filter picker. Only call this after audience_start has been called and the user chose Option B (interactive filter picker). Do not call this tool to guess or pre-populate filters on behalf of the user. RENDERING — M
audience_quick_previewPreview audience size from a free-text description the user provided in this conversation. IMPORTANT: Only call this after audience_start has been called and the user has described their target audience in their own words (Option A). Never pre-select or assume filter values — onl
audience_previewPreview audience size from explicit filter selections made by the user in the filter picker UI. IMPORTANT: Only call this after audience_get_filters has been shown and the user has made their own selections. Never infer or pre-fill filter values — only pass values the user explic
audience_start_runStart a contact pull run for a built audience. Requires audienceId from the build step and totalContacts from preview. If logged in, the run is charged to the account's YourICP billing-token balance (5 billing tokens per contact, where 100 billing tokens = $1.00) and returns a ru
check_billing_balanceRead the YourICP BILLING TOKEN balance this account's runs are charged against. Billing tokens are YourICP's prepaid currency: 100 billing tokens = $1.00, and an audience contact costs 29 billing tokens. They are NOT the auth token — that is the API credential set by set_auth_tok
audience_download_runGet the download link for a completed audience run. Returns a presigned URL the user can click to download their contact list. RENDERING — MANDATORY, VERBATIM: The response contains a download link already formatted as a markdown link with an angle-bracket destination: [Download
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月9日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名はドメイン youricp.com で確認済みです(レジストリがドメインの所有を確認しています)
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- ✓ 合格
エンドポイントが応答する
335ミリ秒で応答(HTTP 200)
- – 対象外
OAuthでサインイン
サインイン不要
- ✓ 合格
ツールの説明に隠れた指示がない
13件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした
マーケティング・SNSのほかのサーバーとの比較i
- このカテゴリのほかの3635件のうち0%よりスターが多い
- このカテゴリのほかの3635件のうち34%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの3635件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
YourICPは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:YOURICP_API_TOKEN
パソコンで動きますか、それともクラウドですか?
どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は–、最新バージョン(0.1.3)がレジストリに届いたのは2 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。
代わりに使えるものは?
同じカテゴリには:MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
YourICP MCP Server
The official, open-source Model Context Protocol (MCP) server for the YourICP contact-enrichment and audience-targeting API. It lets AI assistants such as Claude enrich contacts and build audiences directly from a conversation.
Two ways to run it
This repo (@youricp/mcp) | Hosted connector | |
|---|---|---|
| Transport | stdio, runs on your machine | Streamable HTTP |
| Auth | Paste an API token | OAuth 2.0 + PKCE, browser login |
| Tools | Contact enrichment | Enrichment and audience building |
| Billing | Your existing YourICP plan | Pay-per-use, or your plan |
| Setup | Edit a JSON config file | Paste one URL |
Use the hosted connector unless you specifically want to run the code yourself. It needs no install, stays up to date, and is the only option that exposes the audience-building tools:
https://mcp.youricp.com/sse
Add it in Claude under Settings → Connectors → Add custom connector. See the connector user guide for what you can ask it.
Use this repo if you want to read or modify the code, self-host, run fully offline against your own token, or use a client that only supports stdio. It is a deliberately small reference implementation — no payment, OAuth, or hosting infrastructure required.
Tools
| Tool | Description |
|---|---|
set_auth_token | Set a YourICP auth token for this session |
set_token | Deprecated alias for set_auth_token |
submit_lookup | Enrich contacts by email or LinkedIn URL (returns a jobId) |
check_lookup | Poll the enrichment result for a jobId |
Requirements
- Node.js 18+
- A YourICP auth token — get one at app.youricp.com
Quick start (no install)
Run it directly with npx — no clone, no global install:
YOURICP_AUTH_TOKEN=your_auth_token_here npx @youricp/mcp
Use with Claude Desktop
Add this to your claude_desktop_config.json — npx fetches and runs the server automatically:
{
"mcpServers": { "youricp": { "command": "npx", "args": ["-y", "@youricp/mcp"], "env": { "YOURICP_AUTH_TOKEN": "your_auth_token_here" } } } }
Restart Claude Desktop and the YourICP tools will appear.
Install globally (optional)
npm install -g @youricp/mcp
YOURICP_AUTH_TOKEN=your_auth_token_here youricp-mcp
From source
git clone https://github.com/youricp/mcp-server.git
cd mcp-server npm install YOURICP_AUTH_TOKEN=your_auth_token_here npm start
Or copy .env.example to .env and fill it in, then npm start.
Configuration
| Variable | Default | Description |
|---|---|---|
YOURICP_API_URL | https://app.youricp.com | Base URL of the YourICP API |
YOURICP_AUTH_TOKEN | _(none)_ | Your YourICP auth token |
YOURICP_API_TOKEN | _(none)_ | Deprecated alias for YOURICP_AUTH_TOKEN. Still read, but logs a deprecation notice. |
Two kinds of token
YourICP uses the word "token" for two unrelated things, so this server always says which one it means:
- auth token — the API credential that proves who you are. That is what
YOURICP_AUTH_TOKENandset_auth_tokenset. - billing token — YourICP's prepaid currency for enrichment work, where 100 billing tokens = $1.00. This reference server never touches them.
Contributing
Contributions are welcome! Please read CONTRIBUTING.md and our Code of Conduct. To report a security issue, see SECURITY.md.
License
MIT © YourICP