YourICPConnector User Guide
Enrich contacts and build targeted B2B audiences, directly from your AI chat.
YourICPEnrich contacts and build targeted B2B audiences, directly from your AI chat.
The YourICP connector lets an AI assistant (such as Claude) look up and verify contact details, and build targeted prospect lists, by calling the YourICP data platform on your behalf. This guide explains how to connect it and what you can do once it's set up.
The connector turns your AI chat into a B2B prospecting assistant. There are three main things you'll use it for. You don't need to learn any commands, just ask in plain language and the assistant does the rest.
Turn an email address or LinkedIn profile into full professional details, name, job title, company, and other available business data, and confirm whether an address is valid before you send to it.
"Enrich jane@acme.com and linkedin.com/in/johnsmith."
"Look up the person behind hello@stripe.com, what's their job title?"
"Verify these 20 email addresses and tell me which ones are deliverable."Find net-new prospects that match the firmographics and roles you care about, industry, seniority, location, company size, revenue, department, and buying role. Describe your ideal customer in plain language or pick filters interactively.
"Find VPs of Engineering at SaaS companies in the United States."
"Build me a list of marketing decision-makers at healthcare companies with 200+ employees."
"Help me build an audience, show me the filters I can choose from."See how many contacts and companies match for free before you commit, then pull the contacts and download them as a CSV.
"How many CFOs at fintech companies in California are there?"
"That looks good, pull the first 500 contacts and give me a download link."Add the connector to your AI client using this URL:
https://mcp.youricp.com/sseIn Claude, open Settings → Connectors → Add custom connector, paste the URL above, and follow the prompts. The connector works with any MCP-compatible client; the connection method is negotiated automatically.
You can use the connector in three ways, depending on whether you have a YourICP account.
When you add the connector, your client prompts you for a YourICP Client ID and Client Secret. Enter them in those input fields to connect. With these credentials, your usage draws on your existing YourICP plan, with no per-request payment needed.
If you already have a YourICP API token, just paste it into the chat and ask the assistant to set it. The token is used for the rest of the session and is never stored on disk.
You can use the connector without a YourICP account. In this mode you pay per request through a secure Stripe checkout (see Payment & pricing). Free audience previews are available without paying.
Give the assistant one or more email addresses or LinkedIn profile URLs (up to 50 per request) and ask it to enrich them. You'll get back professional details such as full name, job title, company, and other available business data.
An audience is a targeted list of business contacts matching criteria you choose. You can build one two ways:
Tell the assistant who you're targeting and it matches your description to the available filters automatically.
"VP of Engineering at SaaS companies in the United States"In Claude, you can ask to choose filters and the assistant shows an interactive picker covering:
| Filter | Examples |
|---|---|
| Location | Country, region / state |
| Industry | Software, finance, healthcare, … |
| Seniority | Junior, senior, executive |
| Department | Engineering, sales, customer service, … |
| Buying role | Decision maker, influencer, … |
| Company size | Employee count ranges |
| Revenue | Annual revenue ranges |
If you're not signed in to a YourICP account, paid actions (contact enrichment and audience pulls) are billed per contact through Stripe Checkout. Card details are entered on Stripe's secure page and never pass through this connector.
You normally don't call these directly. Just describe what you want and the assistant picks the right tool. They're listed here for transparency.
| Tool | What it does |
|---|---|
set_token | Sets a YourICP API token you paste into the chat. |
activate_login | Activates a browser sign-in for the session. |
submit_lookup | Submits a contact-enrichment job for emails / LinkedIn URLs. |
check_lookup | Retrieves the result of an enrichment job. |
check_payment | Confirms a checkout payment and continues the request. |
audience_start | Starts the audience-building workflow. |
audience_get_filters | Shows the interactive filter picker. |
audience_quick_preview | Previews audience size from a free-text description. |
audience_preview | Previews audience size from selected filters. |
audience_start_run | Pulls the contacts for a built audience. |
audience_download_run | Returns the download link for a completed run. |
No. You can pay per use without an account, or sign in to use your existing plan. Self-serve sign-up isn't available yet. To request an account, email support@youricp.com.
Up to 50 emails and/or LinkedIn URLs per request.
Paid actions require payment only when you're not signed in. Sign in with your YourICP account to use your plan instead.
In-chat payments are capped at $1,000 per request. Run larger pulls from https://app.youricp.com.
The connector keeps session and payment state in memory only and stores no contact data. See the privacy policy below.
Read the full privacy policy for details on what data is processed and how. For questions, access, correction, or deletion requests, contact privacy@youricp.com.