ravn
Use case

Describe your buyer. Claude builds the list.

Add the Ravn connector to Claude, describe your ideal customer, and Claude chains search_companies, search_people and search_business_email_by_name into a reviewed table. You approve the spend before it runs.

Start free: 1,000 lookups Read the docs

Playbook

From a sentence to a list

  1. / 01

    Add the connector

    In Claude, go to Settings, Connectors, Add custom connector, and paste https://api.askravn.com/mcp. Sign in with your email code and press Allow. In Claude Code, run the claude mcp add command below, then /mcp to authenticate.

  2. / 02

    Install the skill (optional)

    Run npx ravn skill install. It adds a Ravn skill to Claude Code so it knows which tool to pick and how to read the answers. See skills.

  3. / 03

    Describe the customer

    Give industry, employee range, country and the role you sell to. Ask Claude to show you the company list before it searches for people.

  4. / 04

    Review the companies

    Cut any that are wrong. search_companies and search_people run on your own People Data Labs key (connect it with ravn keys add pdl); each company is one lookup, so a first pass of 20 is cheap to check before you scale up.

  5. / 05

    Find people and emails

    Approve the next step. Claude runs search_people for each kept company and confirms a work email for each person.

  6. / 06

    Export

    Ask for a CSV with the columns your CRM expects. Check opt-outs and consent before anything goes into a sequence.

Run it

Connect, then ask

# Claude Code: add the server, then run /mcp and choose Authenticate
claude mcp add --transport http ravn https://api.askravn.com/mcp
npx ravn skill install

# The prompt
Use Ravn to build a prospect list.
Companies: software, 50-200 employees, based in Canada. Find 20 with search_companies
and show me the list before going further.
After I approve: for each company, find up to 2 people with title "Head of Operations"
or "COO" using search_people, then confirm a work email with
search_business_email_by_name. Keep only emails graded A or B.
Before each step, tell me how many lookups it will use.
Output a CSV: company, domain, employees, name, title, email, grade.

The example above, priced

Every tool is one lookup from your plan. People and company lookups also run on your own People Data Labs key, which bills you for the records.

StepCountCost
search_companies20 companies20 lookups (own PDL key)
search_people40 people (2 each)40 lookups (own PDL key)
search_business_email_by_name40 names40 lookups
Total100 lookups

Results that come back empty cost nothing. All 100 lookups fit inside the free plan's 1,000; the people and company records are billed by your own provider. See pricing.

Keep it clean

Rules for the list

Ask Claude to keep the last_updated_at date in the export so you can see how fresh each record is. Telling it to stop and confirm before each paid step is a good habit; agents follow that instruction well and it keeps the bill predictable.

Before you reach out. Contact people only where you have a lawful basis, honour every opt-out, and never use this data for credit, employment, insurance or housing decisions (FCRA uses are forbidden by our terms). People who opt out at our opt-out page are never returned again. The full rules are on the compliance page.

More on how the connector works is on the MCP server page.

FAQ

Common questions.

All questions →

Can Claude sign up for Ravn on its own?

No. A person must receive the 6-digit sign-up code once. After that, Claude can use the connector or a key you give it.

Does this work in Cursor or other MCP clients?

Yes. Any client that supports remote MCP over Streamable HTTP can connect to the same URL, using OAuth sign-in or an Authorization header with your key. Setup for each is in the MCP docs.

How do I stop Claude spending too many lookups?

Tell it to ask before each paid step, and keep limits small. You can also ask it to call get_usage or get_account, which are free, to check what is left.

Can I use the list for ads or audience matching?

Yes, if you have consent to advertise to them: verify the list, then build a hashed audience file locally with npx ravn audience. See hashed email audiences.

More in use cases

Every page uses the same account, plan and tools. See pricing →