YourICP

Connect it to your AI

Claude Code

claude mcp add --transport http youricp https://mcp.youricp.com/sse

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://mcp.youricp.com/sse

claude mcp add youricp -e YOURICP_API_TOKEN=… -- npx -y @youricp/mcp@0.1.3

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "youricp": {
      "url": "https://mcp.youricp.com/sse"
    }
  }
}

Tools it offers

13 tools, as the server itself reported during our check on Oct 31, 2026.

• 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 spend
• 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 ra
• 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
• 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 clie
• 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
• 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 word
• 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
• 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
• 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
• 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

Questions