YourICP MCP Server: B2B Contact Enrichment & Data Cleaning Guide

1. Connecting the connector

Add the connector to your AI client using this URL:

https://mcp.youricp.com/sse

In 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.

2. Connecting your account

You can use the connector in three ways, depending on whether you have a YourICP account.

Option A: Connect with your YourICP credentials recommended

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.

Option B: Paste an API token

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.

Option C: Pay per use (no account)

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.

3. Enriching contacts

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.

"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."

1. Ask the assistant to look up your contacts, e.g. "Enrich jane@acme.com and linkedin.com/in/johnsmith."
2. If you're signed in, the lookup runs immediately. If you're paying per use, you'll get a payment link first, then the lookup starts once you complete it.
3. The assistant retrieves the results and presents the enriched contact data. Larger jobs may take up to a couple of minutes.

4. Building an audience

An audience is a targeted list of business contacts matching criteria you choose. You can build one two ways:

Describe it in plain language

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"

Pick filters interactively Claude only

In Claude, you can ask to choose filters and the assistant shows an interactive picker covering:

1. Ask to build an audience. The assistant offers free-text filtering (any client) or, in Claude, the interactive picker.
2. Make your selections (or describe your target) and the assistant shows a free preview with the estimated number of matching contacts and companies.
3. When you're happy with the size, ask to pull the contacts. Signed-in users run it on their plan; pay-per-use users complete a checkout first.
4. Once the run finishes, you receive a download link for your contact list as a CSV file.

5. Payment & pricing

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.

• The assistant gives you a checkout link and a session ID.
• Complete the payment, then return to the chat. The assistant confirms the payment and continues automatically.
• A single in-chat request is capped at $1,000. Larger jobs should be run from https://app.youricp.com with full account access.
• Audience previews are always free. You only pay when you pull the actual contacts.

6. Tool reference

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.

7. Privacy & support

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.