derrick_account
Check your Derrick account info and remaining credits.
LABSCO SUMMARY
Per-tool credit costs in the descriptions is what makes a metered enrichment platform safe to hand an agent.
Enrichment is priced per record and an agent working a list will happily spend a month's allowance discovering that. Publishing the cost per call means the decision to enrich a thousand rows is made with the number in view. The hiring check is the tool worth noticing beyond the standard enrichment set — it is a timing signal rather than a fact about the company, and timing is what separates an outreach that lands from one that does not. Two things to weigh: several tools find personal contact details including mobile numbers, which carries obligations that vary by jurisdiction and by purpose, and prompt-driven import means an under-specified prompt can spend credits on a list nobody wanted.
What it is
A lead generation and enrichment platform reached through the agent: prompt-driven imports from several sources, person and company enrichment, contact discovery, and account and credit management.
What you get
- Individual tools state their credit cost in their own descriptions, so an agent knows what a call spends before making it.
- Imports driven by plain language rather than filter syntax — describe the ideal lead, describe the companies, or search Google Maps by prompt.
- Contact discovery across the useful directions: find a work email from a name and company, find a mobile from a LinkedIn profile, and reverse a name and domain out of an email address.
- Company enrichment from several angles — LinkedIn attributes, website technologies, page content, recent Google News, and French registry data by SIRET, SIREN or name.
- derrick_is_hiring checks whether a company is currently hiring from its LinkedIn URL, which is a timing signal rather than a static attribute.
- LinkedIn resolution in both directions: find a company profile from a name, find a person's profile from name and company, and import from Sales Navigator.
- companies_by_naf imports by French activity code, which is how you enumerate an industry in that market.
- Account tools covering credits, remaining balance and the upgrade flow, with a help tool the description says to call whenever the question is about Derrick itself.
Requirements
A Derrick API key saved through the configure tool. Calls consume credits at rates the tools state individually.
Setup effort
One command plus a key — npx derrick-mcp, then supply credentials
USE CASES
01
Building a list without learning filter syntax
Describe the leads or companies you want in plain language, or search Google Maps by prompt for local businesses.
02
Finding the person's contact details
Resolve their LinkedIn profile from name and company, then find the work email or the mobile — each tool stating its credit cost.
03
Understanding the company before you write
Enrich with LinkedIn attributes, read its website technologies and page content, and check its recent news.
04
Catching them at the right moment
Check whether the company is currently hiring, which is a timing signal rather than a static attribute.
05
Working the French market
Enrich from SIRET, SIREN or name against the registry, and enumerate an industry by NAF activity code.
06
Working from what you already have
Reverse a name and domain out of an email, pull social profiles and phones off a website, or import an existing Sales Navigator search.
07
Keeping the spend in view
Check the account and remaining credits before a large run, and read the cached balance between calls.
37 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
derrick_companies_by_naf
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.
derrick_configure
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.
derrick_credits
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.
derrick_data_gouv
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).
derrick_enrich_companies
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
derrick_enrich_profile
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
derrick_find_email
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.
derrick_find_gender
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
derrick_find_phone
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.
derrick_find_similar_companies
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.
derrick_find_staff_members
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.
derrick_find_tech
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
derrick_get_name_from_email
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
derrick_google_maps_by_prompt
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.
derrick_google_news
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)
derrick_help
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.
derrick_import_companies_basic
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.
derrick_import_companies_from_prompt
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.
derrick_import_leads_from_prompt
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
derrick_import_post_engagers
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
derrick_import_profile_basic
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.
derrick_import_salesnav_companies
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.
derrick_import_salesnav_leads
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.
derrick_is_hiring
Check if a Company is Hiring For each LinkedIn company URL, check whether the company currently has open roles on LinkedIn Jobs, and get the first matching job titles. Narrow it down by country, posting date or keywords. No LinkedIn account needed. Cost: 1 credit(s) per call. Category: company::enrich
Args: companyLinkedinUrl: LinkedIn company URL column
derrick_linkedin_profile_followers_count
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
derrick_push_to_lemlist
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
derrick_push_to_lgm
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
derrick_search_companies
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
derrick_search_leads_in_companies
Import LinkedIn Leads from Target Companies <strong>Find leads inside a list of target companies</strong>
- Select a Google Sheet column with company LinkedIn URLs
- Paste a <strong>Sales Navigator Lead</strong> 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.
derrick_search_linkedin_profile
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
derrick_serp_first_page
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
derrick_serp_first_result
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
derrick_upgrade
Start the Derrick upgrade / subscription flow. Returns a one-click Stripe Checkout URL for the chosen plan.
Workflow:
- If the user has named a plan (MINI / STANDARD / PLUS / PRO), call with
planset to that name. Returns a Checkout URL the user clicks to subscribe. - 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
planset.
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.
derrick_verify_email
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
derrick_website_contact_social
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)
derrick_website_crawler
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
BEFORE YOU INSTALL
What to know first
Tools you get
37 tools when we connected. A fresh install exposes only derrick_configure and derrick_account; the other tools load dynamically from the API once derrick_configure sets a valid key.
Requires
- npx on PATH
- Node.js 22+
- A Derrick API key (Standard plan or above), saved with derrick_configure or set as DERRICK_API_KEY
CONTEXT COST
Moderate Standing cost
Rated by the size of the 37 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx derrick-mcpMCP Clients
Claude Desktop, Claude Code, Cursor
JSON
{
"mcpServers": {
"derrick": {
"command": "npx",
"args": [
"derrick-mcp"
]
}
}
}No key goes in these blocks. Once the server is connected, tell the AI "Configure Derrick with my API key: YOUR_KEY": derrick_configure saves the key to ~/.derrick-mcp/.env, where it persists across sessions. To set it in the configuration instead, add "env": {"DERRICK_API_KEY": "your-key-here"} to the derrick entry.
Any MCP client
ANY MCP CLIENT · TERMINAL
npx derrick-mcpNo key goes in these blocks. Once the server is connected, tell the AI "Configure Derrick with my API key: YOUR_KEY": derrick_configure saves the key to ~/.derrick-mcp/.env, where it persists across sessions. To set it in the configuration instead, add "env": {"DERRICK_API_KEY": "your-key-here"} to the derrick entry.
