The short answer
TargetWise provides waterfall contact enrichment, company enrichment and reverse email lookup through REST, MCP and a workspace dashboard. Contact lookups use 15+ specialist sources and return available work emails and business phones. Returned phones are unclassified unless the response says otherwise; a returned email is not a deliverability guarantee. See the contact enrichment API.
Until recently, using AI for contact enrichment meant copy-pasting between tabs: you'd ask Claude to draft an email, then leave the conversation, open your data tool, look up the prospect's email and phone, copy it back, and continue. The AI helped with the writing but couldn't touch your data.
The Model Context Protocol (MCP) changed that. It's an open standard that lets AI assistants connect directly to external tools and data sources. Connect an enrichment provider's MCP server to Claude, ChatGPT, or Cursor, and the AI can look up verified emails and mobile numbers inside the conversation — no tab switching, no copy-paste. You ask in plain English; the agent makes the call and returns the result.
This guide covers the mechanics that apply to any MCP-compatible enrichment tool, then walks through a concrete example. The setup pattern is nearly identical across providers — once you understand it for one, you understand it for all.
Last reviewed: 1 October 2026. TargetWise workspace MCP uses https://targetwise.ai/api/mcp with a bearer header. Host availability and authentication support vary; check current official client documentation.
What's in this guide
- What you need before you start
- How enrichment-over-MCP actually works
- How to enrich contacts in Claude
- How to enrich contacts in ChatGPT
- How to enrich contacts in Cursor
- Worked example: enriching with the Targetwise MCP
- Prompts that work (and ones that don't)
- Real MCP interactions, end to end
- Troubleshooting: when the tool won't connect
- Frequently asked questions
1. What you need before you start
Three things, regardless of which AI client or data provider you use:
- A compatible MCP client. It must support remote HTTP MCP and custom Authorization headers for TargetWise’s workspace bearer endpoint. Native cloud connectors may require OAuth, which this endpoint does not currently implement.
- An enrichment provider with an MCP server. Several B2B data tools now expose one. You'll need an account and, in most cases, an API key from that provider's dashboard.
- The provider's MCP server URL and auth method. Usually a URL like
https://mcp.provider.com/mcpplus either an API key (bearer token) or an OAuth sign-in.
Two ways providers handle auth
Authentication is host-specific. TargetWise workspace MCP currently accepts an Authorization: Bearer workspace-key header and does not expose public OAuth for workspace clients. A host’s generic MCP support does not establish that it can authenticate this endpoint.
2. How enrichment-over-MCP actually works
Worth understanding before you wire it up, because it explains what the AI can and can't do. MCP is a standard interface between an AI client and an external tool. When you connect an enrichment provider's MCP server, the provider exposes one or more "tools" — for example, an enrich_contact tool that takes a name and company and returns a verified email and mobile.
In a compatible authorised client, the model can call a discovered enrichment tool and present its actual response. Available fields and uncertainty must remain visible; the client does not turn a returned email into deliverability or an unknown business phone into a verified mobile.
This matters for two reasons. First, the AI handles the orchestration — you don't write code or format API calls. Second, the data quality is only as good as the provider behind the tool. MCP is the pipe; the provider is the water. Connecting a weak data source through MCP just gives you weak data faster. For the architecture behind why some MCP enrichment servers outperform others, see our companion piece on B2B email and mobile enrichment MCP servers.
3. How to enrich contacts in Claude
Claude remote connectors are account-brokered; local Claude Desktop MCP configuration is a separate mechanism. The current remote-connector guide includes Free, Pro, Max, Team and Enterprise users, with one custom connector for Free users. Team and Enterprise administrators control installation.
TargetWise’s workspace endpoint requires a custom bearer header and has no public OAuth. The documented Claude remote-connector setup does not establish custom-header compatibility, so do not promise a direct connection by pasting a key into the UI. Use an approved compatible local client or authenticated integration after verifying its current configuration and secret handling.
Current Claude remote connector documentation
4. How to enrich contacts in ChatGPT
ChatGPT’s authenticated MCP app guidance expects OAuth 2.1. TargetWise’s workspace bearer endpoint does not currently implement that flow, so these workspace instructions do not establish native ChatGPT connector compatibility. Do not paste an API key into a conversation or remove authentication to make a connector work.
An approved integration must satisfy the host’s authentication requirements while keeping workspace credentials on the appropriate server or client boundary. Confirm current plan and administrator permissions in the host; a qualifying plan alone does not fix authentication incompatibility.
Current ChatGPT MCP authentication guidance
5. How to enrich contacts in Cursor
Cursor documents remote MCP configuration with a URL and custom headers. In its MCP configuration, add the server below, supplying the key through the environment or your approved secret mechanism. Reload or reconnect, then inspect discovered tools and test a known record.
{
"mcpServers": {
"targetwise": {
"url": "https://targetwise.ai/api/mcp",
"headers": {"Authorization": "Bearer ${env:TARGETWISE_API_KEY}"}
}
}
}Configuration is host-specific: VS Code uses a servers object and HTTP type; Claude Desktop local servers and other clients have their own transports and settings. Follow the documentation for the exact client and version.
Cursor MCP setup · VS Code configuration reference
6. Worked example: enriching with the Targetwise MCP
Here's the full flow end to end, using Targetwise as the example provider. The same pattern applies to any MCP enrichment tool — swap the URL and key for whichever you use.
- Get a workspace key. Use your authorised workspace key and current subscription balance. Check the current pricing page for trial availability; no fixed 50-enrichment offer is established by this setup guide.
- Add the MCP server. Use the URL
YOUR_TARGETWISE_MCP_GATEWAY_URLwith a bearer-tokenAuthorizationheader — in Claude's Connectors UI, Claude Desktop's config, or Cursor'smcp.json. - Restart or reload the client. The
enrich_contacttool appears in your tool list. - Prompt in plain English. Ask the AI to find an email and mobile for a named contact, or to enrich a list.
Getting your free test key
TargetWise provides waterfall contact enrichment, company enrichment and reverse email lookup through REST, MCP and a workspace dashboard. Contact lookups use 15+ specialist sources and return available work emails and business phones. Returned phones are unclassified unless the response says otherwise; a returned email is not a deliverability guarantee. See the contact enrichment API.
A typical exchange the agent handles natively:
"Find the verified email and mobile for Sarah Chen at TechCorp."
// The agent calls enrich_contact and returns:
{
"status": "matched",
"email": "sarah.chen@techcorp.com",
"mobile": "+1-415-555-0182",
"credits_charged": 2
}
For this workflow, use the current TargetWise plan rates and usage calculator. Paid plans renew monthly; unused balance resets at renewal.
7. Prompts that work (and ones that don't)
The quality of what you get out depends heavily on how you ask. The AI needs enough identifying information to match a contact, and a clear action.
| Works well | Why |
|---|---|
| "Find the email and mobile for Sarah Chen at TechCorp." | Name + company gives a strong match signal. |
| "Enrich this LinkedIn URL: linkedin.com/in/sarah-chen-techcorp" | A LinkedIn URL is a high-confidence identifier. |
| "For each of these 10 prospects, get a verified email — skip any with no match." | Clear batch action with a rule for misses. |
| "Enrich these names, then draft a one-line intro email for each." | Chains enrichment with a downstream task. |
| Works poorly | Why |
|---|---|
| "Find Sarah's email." | No company or identifier — too many Sarahs to match. |
| "Get me everyone at TechCorp." | That's prospecting/search, not enrichment — different tool. |
| "Is this email still valid?" (with no provider that verifies) | Depends on whether your connected tool does verification. |
Use one supported identifier combination. A LinkedIn URL alone is an alternative to a name plus one company identifier, not another field to add to it. Confirm identity first; extra unsupported fields can cause validation errors rather than improve matching.
8. Hypothetical MCP interactions, end to end
These examples explain a workflow; they are not transcripts, real people, measured results or verified contact details.
Single known-person lookup
Ask for available work email for a supported LinkedIn URL, or for Alex Example at example.com using first_name, last_name and company_domain. Request only needed fields and review the actual response.
A bounded list
Iterate one record at a time with an explicit maximum record count, budget and retry limit. Log unresolved fields and stop at the budget boundary. Do not infer a native batch endpoint from a conversational prompt.
Enrich, then act
Keep enrichment separate from sending or CRM writes. Review identity, mailbox status, phone type and permission for the intended action before the caller-controlled next step.
Refine an ambiguous record
Resolve the identity first, then submit one supported identifier combination. A response may include work_email or business_phone; returned emails do not prove deliverability and phones remain unclassified unless evidence identifies their type.
9. Troubleshooting: when the tool won't connect
Most setup failures come down to five causes. Work through them in order — the first two fix the large majority of cases.
| Symptom | Likely cause & fix |
|---|---|
| Tool doesn't appear after adding it | You didn't restart the client. Claude Desktop and Cursor only load new MCP servers on restart — fully quit and reopen, don't just close the window. |
| "Unauthorized" or auth error | Wrong or expired API key, or a malformed Authorization header. Re-copy the key from your provider's dashboard and confirm the format is Bearer YOUR_KEY with a space after "Bearer." |
| No Connectors option at all (ChatGPT) | You're on the free tier. MCP connectors require a paid plan (Plus, Pro, Business, or Enterprise). Upgrade, or use Claude or Cursor instead. |
| Client won't start / config ignored | JSON syntax error in the config file — usually a missing comma, quote, or brace. Paste your config into a JSON validator, fix the error, and restart. |
| Tool connects but returns nothing | The credentials work but the request lacks a strong identifier, or the contact genuinely isn't matchable. Add a company name or LinkedIn URL to the prompt. To rule out a connection problem, test the same key against the provider's REST API. |
Confirm the connection worked
Inspect the host’s actual connected-server and discovered-tool state, authenticated initialization and logs. A model’s statement that it has tools is not connection proof. Then test one known record and verify actual identifiers, returned fields and error handling.
Connect once. Enrich in plain English. Pay only on match.
For this workflow, use the current TargetWise plan rates and usage calculator. Paid plans renew monthly; unused balance resets at renewal.
Get a free test key See pricing →Frequently asked questions
Can I enrich contacts directly inside Claude?
Only through an integration compatible with the current client transport and authentication. Claude cloud remote connectors and local Desktop MCP are distinct. TargetWise workspace MCP requires a custom bearer header and has no public OAuth; the generic connector UI does not establish direct compatibility.
How do I get a Targetwise MCP key?
Obtain an authorised workspace key and use https://targetwise.ai/api/mcp in a client that supports custom bearer headers. Review current plan and trial terms; this article does not promise 50 free enrichments.
Does ChatGPT support contact enrichment via MCP?
ChatGPT supports MCP apps, but its authenticated app guidance expects OAuth 2.1. TargetWise’s current workspace endpoint uses a custom bearer header and has no public OAuth, so a compatible approved integration is required rather than the API-key UI flow previously described.
How do I add an MCP server to Cursor for enrichment?
Configure a remote server at https://targetwise.ai/api/mcp with an Authorization bearer header using your approved secret mechanism. Cursor documents mcpServers URL/header configuration. Reload, inspect discovered tools and test a known record; other hosts use different formats.
What's the difference between enrichment and prospecting in an AI client?
Enrichment fills in contact details for people you can already identify — you give a name and company (or LinkedIn URL) and get back a verified email and mobile. Prospecting finds new people matching a description ("VPs of Sales at Series B companies in the US"). These are different jobs handled by different tools. An enrichment MCP won't build a prospect list from scratch, and a search/prospecting MCP isn't optimized for verifying contact details. Many teams connect both and let the AI use each for its job.
Do I need to be a developer to set this up?
No. The Connectors UI in Claude and ChatGPT lets non-technical users add an MCP server with just a URL and a sign-in — no code or file editing. The config-file method (editing JSON in Claude Desktop or Cursor) is slightly more technical but still just copy-paste. Once connected, enrichment happens entirely in plain English. Developers get extra options — calling the same data via REST API or building it into agent frameworks — but they're not required for basic use.
How much does it cost to enrich contacts through an AI client?
Enrichment uses your provider’s subscription and usage terms, plus any client or integration fees. Set budget and retry limits and measure total cost per usable result. Prompts do not change billing; check current TargetWise pricing and balance expiry terms.
Is enriching contacts inside an AI client secure?
Security depends on host, integration and provider controls. Keep credentials in the approved client/server secret mechanism rather than prompts or shared files; use HTTPS, least privilege, bounded budgets and audit logs. Review data terms and permissions. Neither OAuth nor a generic “reputable” label guarantees the key cannot reach the model.
Why isn't my enrichment tool showing up after I added it?
The usual causes: you didn't restart or reload the client after adding the server (Claude Desktop and Cursor need a restart); the API key is wrong or expired; you're on a plan that doesn't support connectors (ChatGPT free tier is the common one); or the config JSON has a syntax error like a missing comma or quote. Re-check the server URL and auth header, confirm your plan supports MCP, and restart the client. If it still fails, test the same API key against the provider's REST API to confirm the credentials work.
Can the AI enrich a whole list of contacts at once?
A compatible client can orchestrate a bounded sequence of individual requests. Define supported identifiers, record count, budget, retries, no-match handling and review gates. This is not proof of a native batch endpoint or guaranteed faster execution.
Which AI client is best for contact enrichment?
It depends on your workflow. Claude and ChatGPT suit sales and marketing users doing conversational, ad-hoc enrichment — researching a prospect, enriching a short list, drafting outreach in the same thread. Cursor suits developers wiring enrichment into a product or running it in scripts. The underlying data and the enrichment tool are the same across all three via MCP; the client is just the interface. Pick the one your team already works in. If you split between sales and engineering, you can connect the same provider to multiple clients.