Derrick App

@DerrickAppOrg

About Derrick App

No overview available yet

#data #scraping #b2b #enrichment #linkedin #email-finder #phone-finder #email #phone #lead #sales #growth

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "derrick": {
      "command": "npx",
      "args": [
        "derrick-mcp"
      ]
    }
  }
}

Tools

Save your Derrick API key locally. To get your key: install the Derrick Google Sheets extension (https://derrick-app.com), open a sheet > Derrick menu > burger icon > API. Requires Standard plan (€20/mo) or above.

ALWAYS call this tool when the user asks anything about Derrick itself: what it is, what it does, how it works, what features exist, how billing works, what plans exist, what errors mean, or how to scale up. Do NOT answer from memory — call this tool first. Triggers (any language): "what is derrick", "what does it do", "how does it work", "my credits", "how many credits", "errors", "pricing", "plans", "at scale", "in bulk", "c'est quoi derrick", "ça fait quoi", "mes crédits", "les prix", "à grande échelle". Always reply in the user's language and tone. Args: topic (optional): "credits", "errors", "pricing", "scale", "features", or empty for the full overview.

Show the last known Derrick credits balance. Reads from an in-memory cache updated after every API call — no network round-trip. Call this when the user asks how many credits they have left. Always reply in the user's language.

Check your Derrick account info and remaining credits.

Start the Derrick upgrade / subscription flow. Returns a one-click Stripe Checkout URL for the chosen plan. Workflow: 1. If the user has named a plan (MINI / STANDARD / PLUS / PRO), call with `plan` set to that name. Returns a Checkout URL the user clicks to subscribe. 2. If the user just says "upgrade" without picking a plan, call with no argument. The tool returns the live list of plans with prices and credits — ask the user which one, then re-call with `plan` set. ALWAYS call this tool when the user wants to upgrade, go premium, subscribe, or change plan. Do NOT hand out URLs from memory. Triggers (any language): "upgrade", "go premium", "subscribe", "change plan", "unlock API", "passer premium", "souscrire", "changer de plan". Always reply in the user's language and tone.

Google Maps by prompt Type what you are looking for and where (e.g. "growth agency in London") and import up to 200 businesses into a new sheet: name, category, rating, reviews, phone, website, address and attributes. Cost: 1 credit(s) per call. Category: AI Args: prompt: Type what you are looking for and where, e.g. "agence seo marseille" or "growth agency in London". Always include a location.

Import leads from prompt Describe your ideal lead in plain language and import the matching Sales Navigator profiles into a new sheet. Cost: 1 credit(s) per call. Category: AI Args: queryValue: Describe your ideal lead page (optional): Page to start from

Find Name from Email Find firstname, lastname and domain from an email. Cost: 0 credit(s) per call. Category: clean Extracts firstname, lastname, and domain from an email address. Useful for cleanup and parsing. Args: queryValue: Select email column

Find Gender from Name Remove all special characters from a full name and find their firstname, lastname and gender. Cost: 1 credit(s) per call. Category: clean Strips special characters from a full name and returns firstname, lastname, and gender. Args: queryValue: Select fullname column

Verify Email Check if an email address is valid. Cost: 1 credit(s) per call. Category: clean::Lead Returns a certainty level: ultra_sure, sure, risky, invalid, not_found. Charged 1 credit per call EVEN IF not_found. Args: email: Email address to verify

Enrich company by SIRET, SIREN or name Enrich a French company from its SIRET, SIREN, or just its name. Numbers resolve exactly; a name is matched to the best company with a confidence score and the matched name, so you can trust or filter the result. Add a departement to disambiguate. Cost: 1 credit(s) per call. Category: enrich::company FRENCH COMPANIES ONLY. Do NOT call this for non-French companies. Accepts SIRET (14 digits) or SIREN (9 digits). Returns 30+ legal fields: name, address, NAF code, revenue, net result, directors, etc. Args: siret: SIRET (14 chiffres), SIREN (9 chiffres) OU nom d'entreprise locationCode (optional): Département (narrows a company-name search) Options: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 2A, 2B, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 971, 972, 973, 974, 976

Enrich Website with Emails, Phones & Social Profiles Extracts emails, phone numbers, and social media links from a website. Cost: 2 credit(s) per call. Category: enrich::Company Scrapes public emails, phone, and social media links from a website. Emails are usually GENERIC (contact@, hello@) — for a specific person's email use find_email. Charged 2 credits even if no contacts are found. Args: website_url: Enter a full website URL (e.g., example.com)

Enrich Company with Website Technologies Get website technology (CMS, Framework, Analytics, CDN, Hosting, etc.) Cost: 2 credit(s) per call. Category: enrich::Company Detects CMS, framework, analytics, CDN, hosting. Useful for qualifying prospects by stack. Charged 2 credits even if no tech is detected. Args: website_url: Choose Website URL

Enrich Website with Page Content Extract essential web page content: title, meta description, headings (H1-H5), page text (limited to 50,000 characters), and total character count. Cost: 2 credit(s) per call. Category: enrich::Company Args: url_column: Choose URL column

Google News results For each company in your sheet, return its most relevant recent Google News article: title, link, publisher and date. Cost: 1 credit(s) per call. Category: enrich::google Args: companyName: Company name to search news for period: How far back to search Options: 1d, 7d, 30d, 90d, 180d, 365d language (optional): Language of the news sources Options: en, fr, de, es, it, pt, nl context (optional): Context (e.g. telecom)

Enrich Company with LinkedIn Data Enrich companies with +15 attributes from a LinkedIn company URL Cost: 1 credit(s) per call. Category: enrich::linkedin::company Adds +15 LinkedIn attributes (name, description, industry, size, location, website, followers, specialties, etc.). Requires a full LinkedIn URL — if you only have the name, use search_companies first (+1 credit). Requires the Derrick Chrome extension. Args: queryValue: LinkedIn company URL column

Enrich LinkedIn leads with Followers & Connections Count Enrich profiles with follower & connections count Cost: 1 credit(s) per call. Category: enrich::linkedin::lead Returns followers, connections count, and creator/verified status. Useful for qualifying influencers or checking notoriety. Requires the Derrick Chrome extension. Args: queryValue: LinkedIn profiles URL column

Enrich Leads Profile with Data Enrich profiles with +15 attributes from a LinkedIn profile URL Cost: 1 credit(s) per call. Category: enrich::linkedin::lead::essential Adds +15 attributes (name, headline, company, location, summary, education, etc.). Requires the Derrick Chrome extension installed and connected — empty responses usually mean the extension is not connected. If the user only has a name, suggest: search_linkedin_profile (1) + enrich_profile (1) = 2 credits total. Args: queryValue: LinkedIn profiles URL column

Find Work Email Find professional email from Fullname, Company name & Linkedin Company URL. Cost: 5 credit(s) per call. Category: find::lead::essential Charged ONLY on success (5 credits per email found). If the LinkedIn company URL is unknown, suggest chaining: search_companies (1 credit) + find_email (5 credits) = 6 credits total. Always announce the total before calling and wait for confirmation. Args: fullName: Select fullName column: company: Select company column: linkedinCompanyURL (optional): Select linkedin company url column:

Find Mobile Phone from LinkedIn Profile Find any phone from Linkedin Regular Profil Url. Cost: 150 credit(s) per call. Category: find::Lead::Essential HIGH COST: 150 credits per phone found. Charged ONLY on success. ALWAYS announce the cost in bold before calling and wait for explicit confirmation. If the user only has a name, mention chaining: search_linkedin_profile (1) + find_phone (150) = 151 credits total. Args: linkedinProfilUrl: Select LinkedinUrl :

Find Linkedin Company Profile from Name Search company Linkedin URL from company name Cost: 1 credit(s) per call. Category: find::linkedin::company::essential ENTRY POINT for company workflows — use this BEFORE enrich_companies. Also produces the linkedinCompanyURL needed by find_email. The "confidence" field is hidden by the formatter — never ask for it. When chaining with enrich_companies, announce total (1 + 1 = 2 credits). Args: queryValue: Company name column

Find Linkedin profile from Name and Company Find LinkedIn profiles URL from fullname and company (recommended). Cost: 1 credit(s) per call. Category: find::linkedin::lead::essential ENTRY POINT when you only have the name — use this BEFORE enrich_profile. The "confidence" field is hidden from the response by the formatter — never ask for it. If you suspect a low-confidence match, say so in plain language. When chaining with enrich_profile, announce total (1 + 1 = 2 credits) and wait for confirmation. Args: queryValue: Fullname column companyValue (optional): Company column

Import Leads from LinkedIn Sales Navigator Import leads from a LinkedIn Sales Navigator company URL Cost: 1 credit(s) per call. Category: import Args: queryValue: Paste a LinkedIn sales nav URL page (optional): Result page to start from (API only). Overrides the page in the URL. Defaults to the URL's page.

Import Companies by prompt Find companies that semantically match a prompt, optionally filtered by country. Cost: 1 credit(s) per call. Category: import::company Args: description: Describe what kind of company you are looking for. country (optional): Optional country filter. Pick one or more. numberOfResults (optional): Max number of companies to return Options: 10, 20, 50, 100, 200, 300 page (optional): Result page to fetch (API only, 0-indexed). Each page returns up to 20 companies. Defaults to 0.

Import companies by NAF code For each NAF activity code, import the matching French companies from the public SIRENE registry. Add an optional departement to narrow the search. MAX 10k result / search. Cost: 1 credit(s) per call. Category: import::company Args: nafCode: NAF/APE activity code, e.g. 10.71C (bakeries). 1071C also works. locationCode (optional): Département Options: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 2A, 2B, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 971, 972, 973, 974, 976

Import First Google Organic Result Enter text made of the column you want to search Cost: 2 credit(s) per call. Category: import::google Returns the first organic Google result for a query. Useful for finding a person's website, LinkedIn, etc. Args: queryValue: Select values you want to search country (optional): Country Options: us, gb, ca, au, ie, fr, de, es, it, nl, be, ch, at, pt, lu, se, dk, no, fi, pl, cz, ro, gr, br, mx, ar, in, sg, jp, kr, ae, il, za, tr language (optional): Language Options: en, fr, de, es, it, nl, pt, sv, da, no, fi, pl, cs, ro, el, tr, ja, ko, zh, ar, he

Import First-Page Google Organic Results Enter text made of the column you want to search Cost: 3 credit(s) per call. Category: import::google Returns the 10 organic Google results from the first page. More expensive than serp_first_result — use only when multiple sources are needed. Args: queryValue: Select values you want to search country (optional): Country Options: us, gb, ca, au, ie, fr, de, es, it, nl, be, ch, at, pt, lu, se, dk, no, fi, pl, cz, ro, gr, br, mx, ar, in, sg, jp, kr, ae, il, za, tr language (optional): Language Options: en, fr, de, es, it, nl, pt, sv, da, no, fi, pl, cs, ro, el, tr, ja, ko, zh, ar, he

Import Similar Companies Import similar companies from a LinkedIn company ID, optionally filtered by country. Cost: 1 credit(s) per call. Category: import::linkedin Args: linkedinId: LinkedIn company ID of the reference company country (optional): Optional country filter. Pick one or more. maxNumberOfResults (optional): Max number of companies to return Options: 10, 20, 50, 100, 200 page (optional): Result page to fetch (API only, 0-indexed). Each page returns up to 20 companies. Defaults to 0.

Import Leads from LinkedIn Import leads from a LinkedIn people search URL Cost: 1 credit(s) per call. Category: import::linkedin Args: queryValue: Paste a LinkedIn search URL page (optional): Result page to start from (API only). Overrides the page in the URL. Defaults to the URL's page.

Import Companies from Sales Navigator Import companies from a LinkedIn Sales Navigator company URL Cost: 1 credit(s) per call. Category: import::linkedin Args: queryValue: Paste a LinkedIn Sales Nav company URL page (optional): Result page to start from (API only). Overrides the page in the URL. Defaults to the URL's page.

Import a company's people (current & former) Lists people who work or worked at a company: name, role, location and LinkedIn profile. Optionally filter by job function. No Sales Navigator needed. Cost: 1 credit(s) per call. Category: import::linkedin::company Args: company: Company LinkedIn URL or numeric companyId: currentFunction (optional): Filter by linkedin job function Options: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 offset (optional): Absolute result offset to start from (API only, 0-indexed). Defaults to 0.

Import Companies from LinkedIn Import companies from a LinkedIn people search URL Cost: 1 credit(s) per call. Category: import::linkedin::company::essential Args: queryValue: Paste a LinkedIn company search URL page (optional): Result page to start from (API only). Overrides the page in the URL. Defaults to the URL's page.

Import LinkedIn post likes & comments List people who reacted to or commented on a LinkedIn post (name + profile URL + reaction type), from the post URL. Cost: 1 credit(s) per call. Category: import::linkedin::post Args: postUrl: LinkedIn post URL or activity id

Import LinkedIn Leads from Target Companies Find leads inside a list of target companies - Select a Google Sheet column with company LinkedIn URLs - Paste a Sales Navigator Lead search URL defining your lead criteria - Get matching leads from those companies Cost: 1 credit(s) per call. Category: import::sales navigator::lead::company Cross a target company's LinkedIn URL with Sales Navigator criteria. Ideal for ABM. Requires the Derrick Chrome extension AND a Sales Navigator subscription. Cost is VARIABLE: 1 credit per lead returned. Tell the user the cost depends on result count and wait for confirmation. Args: company: LinkedIn company URL (numeric ID only) queryValue: Paste your SalesNav lead search URL page (optional): Result page to start from (API only). Overrides the page in the URL. Defaults to the URL's page.

Push lead to La Growth Machine Push leads from Google Sheets into a La Growth Machine audience - LinkedIn URL plus any fields you map (name, email, phone, company, custom attributes). Connect once, no CSV export. Cost: 0 credit(s) per call. Category: push::La Growth Machine Args: audienceId: Lgm audience to use linkedinUrl: Lead LinkedIn profile URL firstname (optional): Firstname lastname (optional): Lastname gender (optional): Gender (man or woman) bio (optional): Bio companyName (optional): Company name companyUrl (optional): Company URL jobTitle (optional): Job title profilePicture (optional): Profile picture URL twitter (optional): Twitter handle or URL proEmail (optional): Professional email persoEmail (optional): Personal email industry (optional): Industry phone (optional): Phone number crm_id (optional): CRM ID location (optional): Location relationsCount (optional): Relations count leadId (optional): Lead ID customAttribute1 (optional): Custom Attribute 1 customAttribute2 (optional): Custom Attribute 2 customAttribute3 (optional): Custom Attribute 3 customAttribute4 (optional): Custom Attribute 4 customAttribute5 (optional): Custom Attribute 5 customAttribute6 (optional): Custom Attribute 6 customAttribute7 (optional): Custom Attribute 7 customAttribute8 (optional): Custom Attribute 8 customAttribute9 (optional): Custom Attribute 9 customAttribute10 (optional): Custom Attribute 10

Push to lemlist Add a lead to a lemlist campaign. Connect lemlist once, pick the campaign, map the email column (the lead key), and optionally map lemlist lead fields and custom variables. Cost: 0 credit(s) per call. Category: push::lemlist Args: campaignId: lemlist campaign to add leads to email: Lead email (lemlist lead key) firstName (optional): First name lastName (optional): Last name companyName (optional): Company name companyDomain (optional): Company domain jobTitle (optional): Job title linkedinUrl (optional): LinkedIn profile URL phone (optional): Phone picture (optional): Profile picture URL icebreaker (optional): Icebreaker / personalized line timezone (optional): Timezone variable1 (optional): Custom variable 1 (used as {{variable1}} in lemlist) variable2 (optional): Custom variable 2 (used as {{variable2}} in lemlist) variable3 (optional): Custom variable 3 (used as {{variable3}} in lemlist) variable4 (optional): Custom variable 4 (used as {{variable4}} in lemlist) variable5 (optional): Custom variable 5 (used as {{variable5}} in lemlist)

Overview

What is Derrick App?

Derrick App is an MCP server that provides B2B data enrichment tools for any MCP-compatible AI client. It enables users to find emails, enrich LinkedIn profiles, search companies, and more through dynamically loaded tools from the Derrick API.

How to use Derrick App?

Install and configure the server using npx derrick-mcp in your MCP client’s configuration (Claude Desktop, Claude Code, Cursor, or any stdio‑based MCP client). On first use, tell the AI “Configure Derrick with my API key: YOUR_KEY” or set the DERRICK_API_KEY environment variable. The key is saved to ~/.derrick-mcp/.env and persists across sessions.

Key features of Derrick App

Dynamically loads tools from the Derrick API at startup
Two built‑in tools: derrick_configure and derrick_account
Works with any stdio‑based MCP client
API key persistence across sessions
Supports environment variable for API key configuration

Use cases of Derrick App

Find business email addresses for lead generation
Enrich LinkedIn profiles with additional data
Search and research companies for sales prospecting
Check account credits and usage via the derrick_account tool

FAQ from Derrick App

What are the prerequisites to use Derrick App?

You need a Derrick account on the Standard plan ($20/mo) or above, an API key, and Node.js 22+.

How do I install and configure the Derrick App MCP server?

Run npx derrick-mcp in your MCP client’s config file. Detailed JSON examples are provided for Claude Desktop, Claude Code, and Cursor.

How do I set my API key?

Either use the derrick_configure tool by telling the AI “Configure Derrick with my API key: YOUR_KEY”, or set the DERRICK_API_KEY environment variable in the server configuration.

What tools are available besides the built‑in ones?

All other tools are loaded dynamically from the Derrick API. Ask the AI “What can Derrick do?” to see the full list.

Where is my API key stored after configuration?

The key is saved to ~/.derrick-mcp/.env and persists across sessions.

Frequently asked questions

What are the prerequisites to use Derrick App?

You need a Derrick account on the Standard plan ($20/mo) or above, an API key, and Node.js 22+.

How do I install and configure the Derrick App MCP server?

Run `npx derrick-mcp` in your MCP client’s config file. Detailed JSON examples are provided for Claude Desktop, Claude Code, and Cursor.

How do I set my API key?

Either use the `derrick_configure` tool by telling the AI “Configure Derrick with my API key: YOUR_KEY”, or set the `DERRICK_API_KEY` environment variable in the server configuration.