# DataRevIQ MCP

Connect DataRevIQ to Claude and ask for your Resolutions in plain English.

Setup takes about 2 minutes.

New to this? Copy the setup prompt, paste it into Claude, and it walks you through.

MCP Server URL:

```
https://mcp.datareviq.io/functions/v1/mcp
```

Paste the MCP Server URL into Claude. Do not open it in a browser, it only works inside an AI assistant.

- Sign-in: none. You send a key in a header, or add ?key= and your key to the address.
- Access: read only. Reads are free.

A Resolution is a website visitor we identified, checked against your ideal customer profile and verified. An ICP Fit Resolution matches your ICP. A High Intent Resolution is an ICP Fit visitor who is showing strong buying signals. A Returned Visitor Resolution came back to your site more than once.

## MCP Server URL

```
https://mcp.datareviq.io/functions/v1/mcp
```

- Read only
- Reads are free
- Works inside Claude

## What you can ask

- ICP Fit Resolutions: people who match your ideal customer profile, verified.
- High Intent Resolutions: ICP Fit visitors showing strong buying signals.
- Returned Visitor Resolutions: visitors who came back to your site more than once.

Read only. Reads are free.

You need a DataRevIQ account with the pixel installed on your site. The free plan works.

## Step 1. Get your key

A key is like a password that lets Claude see your Resolutions. Keep it private. Only an account owner can create keys. Anyone who has it can read your contacts. If you think your key was shared, revoke it in the app and create a new one.

1. Open the app at https://app.datareviq.io and sign in.
2. Click MCP in the left menu.
3. Click Create key and name it Claude.
4. Copy the key. It starts with drq_live_. We show it once, so copy it now.

## Step 2. Connect Claude

MCP Server URL:

```
https://mcp.datareviq.io/functions/v1/mcp
```

Paste the MCP Server URL into Claude. It will not open in a web browser.

**Option A. Easiest, Claude on the web or desktop**

1. Open Customize, then Connectors, then Add custom connector.
2. Name: DataRevIQ
3. In the URL box paste your personal address: the MCP Server URL, then ?key= and your key.

```
https://mcp.datareviq.io/functions/v1/mcp?key=YOUR_KEY
```

Replace YOUR_KEY with the key you copied in Step 1. Your address now includes your key, so treat it like a password and do not share it.

4. Leave Authentication on No sign-in. Click Add. You should see DataRevIQ in your connectors list.

Prefer to let your assistant do it? Copy this setup prompt and paste it into your chat:

```setup-prompt
Help me connect the DataRevIQ MCP server. MCP Server URL: https://mcp.datareviq.io/functions/v1/mcp (remote HTTP). If my client has no field for headers, use the address with ?key= followed by my key. Otherwise send the header Authorization with the value Bearer followed by my key. Walk me through it one step at a time, then run get_summary to confirm it works.
```

**Option B. Claude Code (one command)**

1. Copy the command below.
2. Replace YOUR_KEY with your key.
3. Paste it into your terminal and press Enter. You should see a message that datareviq was added.

```command
claude mcp add --transport http datareviq https://mcp.datareviq.io/functions/v1/mcp --header "Authorization: Bearer YOUR_KEY"
```

Developers: use this one. The key is sent in a header and does not appear in the address.

**Option C. If your Claude shows a Request headers box**

Add a header named authorization with the value Bearer, a space, then your key, and use the plain MCP Server URL with no key.

## Step 3. Test it

Open a new chat and ask:

```
How many ICP Fit Resolutions do I have?
```

If Claude asks permission to use a DataRevIQ tool, choose Always allow. All three tools only read data.

If Claude shows your counts, you are connected.

3 steps. About 2 minutes. $0 to read.

## Send your Resolutions where you work

Connect DataRevIQ and the app you already use in the same Claude chat. Then ask Claude to move your verified contacts for you.

```prompt
List my ready-to-contact ICP Fit Resolutions from this week and add them to my Google Sheet called Pipeline.
```

```prompt
Take my High Intent Resolutions and create contacts in my CRM, with their verified business emails.
```

```prompt
Send me a Slack message every morning with my new Returned Visitor Resolutions.
```

Needs your Slack connector and Claude scheduled tasks.

```prompt
Draft a short first email to each of my High Intent Resolutions, using the pages they viewed.
```

DataRevIQ only reads. Claude uses the other app's own connector to write to it, so add that connector in Claude first (Customize, then Connectors). You can also push contacts straight to your CRM or sequencer from the DataRevIQ app, no Claude needed.

## What teams use it for

1. **Morning pipeline check**: ask for yesterday's ICP Fit Resolutions before your first call.
2. **Who to contact first**: get High Intent Resolutions so reps start with the warmest buyers.
3. **Returning visitors**: see who came back to your site and which pages they read.
4. **Fill your CRM**: add verified contacts to your CRM with the connector you already use in Claude.
5. **Brief for sales calls**: get a short note on a contact's visits before you talk to them.
6. **Weekly summary**: get a weekly count of new, High Intent and returning Resolutions.

## Works with

1. Claude on the web and desktop. Tested.
2. Claude Code. Tested.
3. Other agents that support remote MCP servers. Not tested yet by us. Copy the setup prompt and paste it into your agent.

## FAQ

### What is the MCP?

A connector that lets Claude read your DataRevIQ Resolutions, so you can ask about them in plain English.

### Is it free?

Yes. Reading your Resolutions through the MCP costs nothing.

### Can it change my account?

No. It is read only. It cannot change, delete or send anything in your account.

### Who can create a key?

Only the account owner, in the app under MCP.

### Is my data private?

Your key stays private to you. Anyone with it can read your contacts, so keep it safe. You can revoke it anytime in the app.

### Which assistants work?

Claude on the web, Claude desktop and Claude Code are tested. Other agents that support remote MCP servers should work, but we have not tested them yet.

## Need help?

Email hello@datareviq.io and we will connect it with you.

## Tools and limits (for developers)

### Use it in another assistant

Any assistant that can connect to a remote MCP server over HTTP can use DataRevIQ. We have tested Claude so far. Give your assistant this:

> Connect to the DataRevIQ MCP server at https://mcp.datareviq.io/functions/v1/mcp. It is a remote HTTP server. Send the header "Authorization: Bearer YOUR_KEY". If you cannot send headers, use the address with ?key=YOUR_KEY instead. Then call get_summary and tell me how many ICP Fit, High Intent and Returned Visitor Resolutions I have.

Replace YOUR_KEY with your key first.

### Tools

| Tool | What it returns | Inputs |
|---|---|---|
| list_contacts | Your verified contacts | icp_fit, band, returned, ready, since, search, limit, offset |
| get_summary | Counts for your site | since |
| get_credits | Your credit balance and plan | none |

Inputs for list_contacts:

- icp_fit: true returns only ICP Fit Resolutions.
- band: hot, warm or cold intent.
- returned: true returns only people who came back.
- ready: true returns only contacts ready to contact (verified, with a deliverable business email).
- since: an ISO date, for example 2026-11-01. Only visits since then.
- search: a name, company or title.
- limit: 1 to 100. Default 25.
- offset: where to start, for paging.

get_summary returns: identified, icp_fit, ready_to_contact, high_intent, returned, needs_email, in_pipeline, customers.

### What to ask

- How many ICP Fit Resolutions do I have this week?
- List my High Intent Resolutions with their verified emails.
- Which Returned Visitors came back today?
- Show me ICP Fit contacts at companies that mention "security".
- How many credits do I have left?

### What you get back

- Only verified contacts. We read the person's LinkedIn profile, or confirm their identity with their own email, and a contact must have a deliverable business email.
- Each contact includes name, title, company, company website, location, business email, LinkedIn link, verification level, ICP fit, intent, pages viewed, last seen, whether they returned, and stage.
- verification_level is business_verified (identity confirmed from the LinkedIn profile) or email_verified (identity confirmed from the person's own email).
- Personal email addresses are never returned for B2B accounts.
- Free accounts also get a locked list. Each locked entry shows the company, industry, seniority, department, ICP fit, intent, pages viewed and last seen. The person's name and email unlock in the app with credits (1 credit per contact).

### Limits

- 60 requests per minute for each key.
- Up to 100 contacts per request. Use offset to get more.
- A key works for one site. Create a key for each site.
- Read only. The MCP cannot change anything in your account.

### If something goes wrong

- Claude says the key is invalid: the header value must be the word Bearer, a space, then the key, with nothing extra. Create a new key in the app and try again.
- Claude cannot connect: check the address ends with ?key= followed by your whole key, with no spaces.
- The list is empty: your site has no verified ICP Fit visitors for that filter yet. Ask for get_summary to see your counts.
- Claude says it cannot connect: check the header value starts with the word Bearer, then a space, then the key. Create a new key if unsure.
- The MCP Server URL shows an error in my browser: that is expected. It only works inside an AI assistant.
- Too many requests: wait 30 seconds and try again.
- Anything else: hello@datareviq.io
