MCP Server - Crustdata Docs

This page documents the original Crustdata MCP server, where the assistant calls one tool at a time. For the newer MCP server — natural-language access with real-time credit reporting — head there instead.

The Crustdata MCP server gives AI assistants direct access to 800M+ professional profiles and 200M+ companies. Connect it to Claude.ai, Claude Code, or any MCP-compatible client to search, enrich, and analyze B2B data through natural language.

Demos

Claude Code Demo

See Crustdata MCP in action with Claude Code — search companies, enrich profiles, and analyze jobs through natural language.

Terminal Demo

Watch the MCP server running in a terminal with the STDIO transport.

Quick Start

Add the MCP connector

Go to claude.ai, click your profile icon → Settings → Integrations → Add more → Add custom MCP.

Configure the connection

Name: Crustdata
URL: https://mcp.crustdata.com/mcp

Click Add to save.

Authenticate

You’ll be redirected to a login page. Paste your Crustdata API key or sign in with your Crustdata account.Don’t have an API key? Sign up at crustdata.com to get one.

Start using it

All 23 tools are immediately available. Try one of the example prompts below.

Example Prompts

Once connected, you can ask Claude questions like:

Prompt	What it does
”Find software engineering jobs at Anthropic”	Searches the job database with filters
”What jobs does Stripe have open right now?”	Fetches live job listings in real-time
”Find the profile for jane.doe@gmail.com”	Reverse lookup by personal email
”Show me AI startups with 100-500 employees”	Searches company database with headcount filter
”Who are the engineering leaders at Anthropic?”	Searches people by seniority and company
”Get me the email for this person’s profile”	Enriches a person profile with contact info
”Compare job openings at Anthropic, OpenAI, and Cohere”	Batch job search across multiple companies
”What is Anthropic posting about on social media?”	Fetches recent social media posts
”How many credits do I have?”	Checks your account balance

Tools

The MCP server provides 23 tools organized into six categories.

Company Tools

Tool	Description
`identify`	Match companies by name, domain, or profile URL (free)
`enrich`	Get comprehensive company profile (headcount, funding, revenue, etc.) — 1-4 credits
`search_db`	Search company database with filters (industry, headcount, location, funding) — 1 credit
`search`	Real-time company search with advanced filters — 1+ credits
`autocomplete`	Discover valid company filter values (free)

People Tools

Tool	Description
`enrich`	Get person profile by profile URL, business email, or personal email — 2-5 credits
`search_db`	Search people database with filters (title, company, seniority, skills) — 3 credits/100
`search`	Real-time people search with advanced filters — 1+ credits
`autocomplete`	Discover valid person filter values (free)

Job Tools

Tool	Description
`job_search`	Search job database with filters, sorting, pagination, and aggregations — 1 credit/job
`job_search_live`	Fetch live job listings in real-time for a single company — 1 credit/job
`batch_job_search`	Async batch job search for up to 10 companies at once — 1 credit/job
`batch_job_search_live`	Async batch live job search across up to 10 companies — 1 credit/job

Posts

Tool	Description
`social_posts`	Fetch social media posts by person or company profile URL — 1 credit
`company_social_posts`	Search social media posts by keyword — 1 credit

Watcher Tools (Webhooks)

Tool	Description
`watcher_create`	Create a webhook to monitor job postings, social media posts, or profile changes — 1 credit
`watcher_update`	Update an existing watcher (pause, resume, change endpoint) — free
`watcher_simulate`	Test a watcher configuration without creating it — free
`watcher_list`	List all your active watchers — free

Utility Tools

Tool	Description
`credits_check`	Check your current credit balance and account tier — free
`autocomplete_filter`	Discover valid search filter values — free
`web_search`	Search the web via Crustdata’s search API — 1 credit
`web_fetch`	Fetch and extract content from a webpage — 1 credit

All tool names are prefixed with crustdata_ when called via MCP (e.g., identify → crustdata_company_identify). Company and people tools also include the category prefix (company_, people_).

Authentication

The MCP server uses OAuth 2.1 with Dynamic Client Registration. When you connect from Claude.ai:

Claude initiates the OAuth flow automatically.
You’re redirected to a login page where you either paste your API key or sign in via your Crustdata account.
The key is validated and used for all subsequent API calls.

Your API key is never stored on the MCP server — it’s passed through to the Crustdata API on each request.

Common Workflows

Research a company:

Ask Claude to identify the company (free) → enrich it with specific fields → check social media posts for recent activity.

Find decision-makers:

Search people by company + seniority + title → enrich for contact info (emails, phone numbers).

Hiring analysis:

Search jobs by company/title/location → use aggregations to get breakdowns by category or location.

Competitive intelligence:

Compare job openings across competitors using batch job search → analyze social media post activity.

Troubleshooting

Error	Cause	Fix
Authentication failed	Invalid or expired API key	Re-authenticate with a valid key
Insufficient credits	Account has no remaining credits	Top up credits at app.crustdata.com
Rate limit exceeded	Too many requests per minute	Wait and retry, or reduce request frequency
Person not found	Profile not in database	Try with `enrich_realtime=true` for a live lookup
Request timed out	Query too broad	Add more specific filters or reduce the limit

Transport & Security

Transport: Streamable HTTP
Endpoint: https://mcp.crustdata.com/mcp
TLS: HTTPS via AWS ALB with ACM certificate
Auth: OAuth 2.1 with Dynamic Client Registration
Safety annotations: All tools include readOnlyHint, destructiveHint, and openWorldHint annotations

Support

For help or feedback, contact support@crustdata.com.

​Demos

Claude Code Demo

Terminal Demo

​Quick Start

​Example Prompts

​Tools

​Company Tools

​People Tools

​Job Tools

​Posts

​Watcher Tools (Webhooks)

​Utility Tools

​Authentication

​Common Workflows

​Troubleshooting

​Transport & Security

​Support

Demos

Quick Start

Example Prompts

Tools

Company Tools

People Tools

Job Tools

Posts

Watcher Tools (Webhooks)

Utility Tools

Authentication

Common Workflows

Troubleshooting

Transport & Security

Support