English Français العربية

YourICP

السجل الرسمي الإنتاجية

Enrich contacts by email or LinkedIn URL and build targeted B2B audiences.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http youricp 'https://mcp.youricp.com/sse'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "youricp": {
            "type": "http",
            "url": "https://mcp.youricp.com/sse"
        }
    }
}
NPM package @youricp/mcp
Claude Code 
claude mcp add youricp -e 'YOURICP_API_TOKEN=<your youricp_api_token>' -e 'YOURICP_API_URL=<YOURICP_API_URL>' -- npx -y @youricp/mcp@0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "youricp": {
            "command": "npx",
            "args": [
                "-y",
                "@youricp/mcp@0.1.3"
            ],
            "env": {
                "YOURICP_API_TOKEN": "<your youricp_api_token>",
                "YOURICP_API_URL": "<YOURICP_API_URL>"
            }
        }
    }
}

متغيرات البيئة

  • YOURICP_API_TOKEN إلزامي سري Your YourICP API token. Get one at https://app.youricp.com
  • YOURICP_API_URL Base URL of the YourICP API (defaults to https://app.youricp.com)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. YourICP MCP Server
  2. Two ways to run it
  3. Tools
  4. Requirements
  5. Quick start (no install)
  6. Use with Claude Desktop
  7. Install globally (optional)
  8. From source
  9. Configuration
  10. Contributing
  11. License

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
Transportstdio, runs on your machineStreamable HTTP
AuthPaste an API tokenOAuth 2.0 + PKCE, browser login
ToolsContact enrichmentEnrichment and audience building
BillingYour existing YourICP planPay-per-use, or your plan
SetupEdit a JSON config filePaste 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

ToolDescription
set_auth_tokenSet a YourICP auth token for this session
set_tokenDeprecated alias for set_auth_token
submit_lookupEnrich contacts by email or LinkedIn URL (returns a jobId)
check_lookupPoll the enrichment result for a jobId

Requirements

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

VariableDefaultDescription
YOURICP_API_URLhttps://app.youricp.comBase 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_TOKEN and set_auth_token set.
  • 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

الأسئلة الشائعة

ما هو YourICP؟

Enrich contacts by email or LinkedIn URL and build targeted B2B audiences.

كيف أثبّت YourICP؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http youricp 'https://mcp.youricp.com/sse'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج YourICP إلى مفتاح API؟

نعم. يتطلب YOURICP_API_TOKEN، وتضبطها في إعداداته.

هل YourICP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون YourICP؟

ينشره YourICP. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.