
Suggest exact values for a person search field (titles, employers, countries...). Free. Use before searchpeoplein_db so filters use values that exist in the index; pass suggestions verbatim.
Suggest exact values for a company search field (industries, names, countries, round types...). Free. Use before screen_companies so filters use values that exist in the index; pass suggestions verbatim.
Suggest exact values for the real-time search filters REGION, INDUSTRY, titles, and SCHOOL. Free. Use before searchcompanies or searchpeople and pass suggestions verbatim as filter values.
Resolve companies from domains, names, LinkedIn company URLs, or Crustdata IDs (one kind per call, max 25). Returns ranked matches with crustdatacompanyid and basic info. Free. Use before enrich_company when the input is ambiguous.
Get full company profiles (firmographics, headcount, funding, people, news...) for up to 25 companies by domain, name, LinkedIn URL, or Crustdata ID. 2+ credits per company; choose sections via fields. Use identify_company first when the input is ambiguous.
Search Crustdata's company database with field filters and/or a ranked natural-language query. Returns companies with crustdatacompanyid for enrichcompany. 0.03 credits per result. Use autocompletecompanyfield for valid filter values; pass pageinfo.cursor for the next page.
Search companies in real time on LinkedIn data by industry, headcount, region, revenue, growth, technologies, and more. 2 credits per result. Use autocompletefilters for REGION and INDUSTRY values; prefer screencompanies for cheaper indexed search.
Search Crustdata's job listing database by company, title, category, location, posting date, or description text, with optional count/group-by aggregations. 0.03 credits per listing. Use identifycompany for company IDs; pass pageinfo.cursor for the next page.
Get person profiles (employment history, education, location) for up to 25 LinkedIn profile URLs from Crustdata's dataset. 1+ credits per profile; choose sections via fields. Use searchpeoplein_db to find profile URLs.
Search people in real time on LinkedIn data by current/past title and company, seniority, function, region, school, and more. 2 credits per result. Use autocompletefilters for REGION, title, and school values; prefer searchpeopleindb for cheaper indexed search.
Search Crustdata's person database with field filters (title, employer, seniority, location, school...) and/or a ranked natural-language query. Returns profileurl for enrichperson. 0.03+ credits per result. Use autocompletepersonfield for valid values; pass page_info.cursor for the next page.
Fetch a person's recent LinkedIn posts live by profile URL, optionally with reactors and comments. 1 credit per post. Use getcompanylinkedinposts for a company's posts and searchlinkedinpostsby_keyword to search by topic.
Fetch a company's recent LinkedIn posts live by domain, name, LinkedIn URL, or Crustdata ID, or one post by URL, optionally with reactors and comments. 1 credit per post. Use identifycompany for IDs and getsocial_posts for a person's posts.
Search LinkedIn posts live by keyword, with recency, media type, and author/company/mention filters. 1 credit per post (3 with exactkeywordmatch). Use getsocialposts or getcompanylinkedinposts for one author's feed, searchindexedsocialposts for structured search.
Search Crustdata's indexed LinkedIn post dataset with structured filters (text, author, company, location, date, engagement) and sorting. 0.5 credits per post; limit 0 returns a free count. Pass page_info.cursor for the next page.
Get the remaining API credits for the authenticated Crustdata account, including any recurring grant. No credits consumed. Use to check balance before running credit-consuming operations.
Validate Crustdata credentials. Verifies credentials during setup.
Create a new watch to track events like job postings. Specify event type, filters for events/leads/accounts, a webhook URL for notifications, frequency in days, and an expiration date. Returns the created watch with its ID and status.
Update an existing watch by ID. Can change status to 'paused' or 'active', update the webhook URL, modify event filters (lead watches only), or adjust max notifications per run. At least one field must be provided.
Get details of a specific watch by its ID. Returns the watch configuration including event type, filters, webhook URL, frequency, status, and expiration date.
List all watches for the authenticated account. Returns all active and paused watches with their configurations.
Search the web live across web, news, scholar, AI-overview, and social sources, optionally by country, site, or date range. 1 credit per call. Use web_fetch on result URLs to read full pages.
Fetch the live HTML and title of 1-10 web pages. 1 credit per URL, including URLs that fail. Pages may return in any order; failures list each failed URL with the reason. Use web_search to find URLs.

In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}It's an MCP server that lets your agents tap into Crustdata's B2B data platform via tools. Your agents can invoke these tools to search for companies by firmographic filters, enrich contact and company profiles, track job listings, monitor LinkedIn activity, and more.
Crustdata doesn't offer an official MCP server, but you can use one from a third-party platform, like Merge Agent Handler.
The use cases naturally depend on the agent you've built, but here are a few common ways to use a Crustdata MCP server:
Here are some of the most commonly used tools:
search_companies: queries Crustdata's company database using filters like industry, headcount, funding stage, and geography. Use this when an agent needs to build a prospect list or identify accounts that match a specific ICPenrich_company: returns detailed firmographic data for a specific company, including funding history, employee count, tech stack, and headquarters location. Helpful when an agent needs to fill gaps on a known account before routing it to a sales repsearch_people: finds professional profiles using filters like job title, company, seniority level, and location. Good for workflows that need to surface decision makers at a target accountenrich_person: pulls detailed profile data for a specific individual, including current role, employment history, and contact signals. Call this when an agent needs to verify or expand a contact record before outreachsearch_job_listings: returns open job postings at companies, filterable by role type, department, and seniority. Useful for agents that treat hiring activity as a buying signal or use it to qualify accountscreate_watch: sets up a monitor on a company or person that triggers when specified conditions change, such as a funding round or executive hire. Use this when an agent needs to react in real time to account-level eventsIf you're comparing Merge Agent Handler's Crustdata MCP server against other options, here's what sets it apart:
You can take the following steps:
1. Create or log into your Merge Agent Handler account and navigate to Tool Packs (collections of connector tools scoped to a specific use case).
2. Create a new Tool Pack, then find and enable the Crustdata connector. Select which tools to include: read tools like search_companies and enrich_person work well for prospecting and enrichment use cases, while create_watch and update_watch are useful if your agent needs to track changes over time.
3. Add a Registered User inside the Tool Pack. This is the identity context under which your agent operates. Merge generates a unique MCP URL scoped to this user once it's created.
4. From the Registered User detail page, authenticate Crustdata by entering your API credentials. Merge stores and manages those credentials going forward.
5. Copy the MCP URL from the Tool Pack detail page and generate an API key from Settings. You'll need both to connect your agent.
6. Add the MCP server to your agent or IDE using the MCP URL and API key. Your Crustdata tools are now accessible through that endpoint.
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now