> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crustdata.com/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP Server
> Connect Crustdata's B2B data platform to Claude and other AI assistants via the original MCP server (direct tool calls).
This page documents the **original** Crustdata MCP server, where the
assistant calls one tool at a time. For the newer
**[MCP server](/for-agents/mcp)** — 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
See Crustdata MCP in action with Claude Code — search companies, enrich
profiles, and analyze jobs through natural language.
Watch the MCP server running in a terminal with the STDIO transport.
## Quick Start
Go to [claude.ai](https://claude.ai), click your profile icon → **Settings** → **Integrations** → **Add more** → **Add custom MCP**.
* **Name:** Crustdata
* **URL:** `https://mcp.crustdata.com/mcp`
Click **Add** to save.
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](https://crustdata.com) to get one.
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](mailto: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:
1. Claude initiates the OAuth flow automatically.
2. You're redirected to a login page where you either paste your API key or sign in via your Crustdata account.
3. 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:**
1. Ask Claude to identify the company (free) → enrich it with specific fields → check social media posts for recent activity.
**Find decision-makers:**
1. Search people by company + seniority + title → enrich for contact info (emails, phone numbers).
**Hiring analysis:**
1. Search jobs by company/title/location → use aggregations to get breakdowns by category or location.
**Competitive intelligence:**
1. 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](https://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](mailto:support@crustdata.com).