# Crustdata — how to use (mcp.ai)

Connect your Crustdata account and use 15 tools for sales and CRM straight from your AI agent. Connect with your own API key. CrustData is an AI-powered data intelligence platform that provides real-time company and people data via APIs and webhooks, empowering B2B sales teams, AI SDRs, and investors to act on live signals.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_crustdata?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `crustdata_enrich_person_screener`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/crustdata`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/crustdata/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/crustdata/enrich/person/screener` — The screener_person_enrich endpoint enriches person data by providing additional information based on the given query. It allows users to retrieve detailed information about individuals, which can be 
  - body: { fields: string, enrich_realtime: boolean, linkedin_profile_url: string }
- `POST https://api.mcp.ai/api/crustdata/fetch/headcount/by/facet/timeseries` — Retrieves headcount data as a timeseries with faceted analysis capabilities. This endpoint allows users to fetch detailed headcount information over time, applying complex filters, pagination, and sor
  - body: { count: integer, sorts: object[], offset: integer, filters__op?: string, filters__conditions?: object[] }
- `POST https://api.mcp.ai/api/crustdata/fetch/investor/portfolio/data` — Retrieves comprehensive investor portfolio data from the Data Lab section of the CrustData API. This endpoint provides access to detailed information about investor portfolios, including investment ho
  - body: { investor_name: string }
- `POST https://api.mcp.ai/api/crustdata/filter/decision/makers/data` — Filters and retrieves decision maker data from the CrustData B2B SaaS integration platform based on complex criteria. This endpoint allows for advanced querying of decision maker information using a c
  - body: { count: integer, sorts: object[], offset: integer, filters__op?: string, filters__conditions?: object[], decision_maker_titles: string[] }
- `POST https://api.mcp.ai/api/crustdata/post/funding/milestone/time/series/data` — The FundingMilestoneTimeseries endpoint retrieves time-series data related to funding milestones for companies. It allows for complex querying of funding events over time, with flexible filtering, pag
  - body: { count: integer, sorts: object[], offset: integer, filters__op?: string, filters__conditions?: object[] }
- `POST https://api.mcp.ai/api/crustdata/post/headcount/timeseries/data` — Retrieves filtered and sorted headcount timeseries data from the CrustData Data Lab. This endpoint allows for complex querying of historical headcount information, enabling users to analyze workforce 
  - body: { count: integer, sorts: object[], offset: integer, filters__op?: string, filters__conditions?: object[] }
- `POST https://api.mcp.ai/api/crustdata/post/job/listings/table/data` — This endpoint retrieves filtered and sorted job listings data for specified company tickers from a chosen dataset in the CrustData platform. It allows for highly customizable queries with complex filt
  - body: { count: integer, sorts: object[], offset: integer, tickers: string[], dataset__id?: string, filters__op?: string, dataset__name?: string, filters__conditions?: object[] }
- `POST https://api.mcp.ai/api/crustdata/post/web/traffic/data` — Retrieves filtered and sorted web traffic data from the CrustData platform. This endpoint allows for complex querying of web traffic information using nested conditions and logical operators. It suppo
  - body: { count: integer, sorts: object[], offset: integer, filters__op?: string, filters__conditions?: object[] }
- `POST https://api.mcp.ai/api/crustdata/retrieve/linked/in/posts` — Retrieves LinkedIn posts for a specified company using CrustData's screener functionality. This endpoint allows users to gather social media data from LinkedIn, which can be used for analyzing company
  - body: { company_linkedin_url: string }
- `POST https://api.mcp.ai/api/crustdata/screen/metrics/and/filter/conditions` — The ScreenData endpoint enables advanced data screening and filtering on the CrustData platform. It allows users to construct complex queries for retrieving specific datasets based on custom metrics, 
  - body: { count: integer, sorts: object[], offset: integer, metrics: object[], filters__op?: string, filters__conditions?: object[] }
- `POST https://api.mcp.ai/api/crustdata/screener/company/information` — The GetCompanyScreener endpoint allows users to search and filter companies based on various criteria such as headcount, growth rate, funding, and more. It provides a powerful way to identify specific
  - body: { company_domain: string, enrich_realtime: string }
- `POST https://api.mcp.ai/api/crustdata/search/companies/with/filters` — The CompanySearch endpoint enables users to search and filter companies using the CrustData API. It provides a powerful mechanism for querying company data based on multiple criteria, supporting compl
  - body: { page: integer, filters: object[] }
- `POST https://api.mcp.ai/api/crustdata/search/for/job/id/in/screener` — The screener_person_search endpoint allows users to search for persons associated with a specific job ID within the CrustData B2B SaaS integration platform. This POST request accepts a JSON payload co
  - body: { page?: integer, job_id: string }
- `POST https://api.mcp.ai/api/crustdata/search/linked/in/posts/by/keyword` — This endpoint enables searching for LinkedIn posts using a specific keyword. It allows users to retrieve relevant content from LinkedIn by specifying a search term, along with options for pagination, 
  - body: { page: integer, keyword: string, sort_by: string, date_posted: string }
- `POST https://api.mcp.ai/api/crustdata/validate/credential` — Validate Crustdata API credentials by testing authentication with a lightweight API call. Use this action when you need to verify that API credentials are valid and properly configured before making o

## Example prompts
- "What can I do in Crustdata?"
- "Show me a summary of my Crustdata account"

## More
- Page: https://mcp.ai/crustdata
- Agent spec (llms.txt): https://mcp.ai/crustdata/llms.txt
- Postman collection: https://mcp.ai/crustdata/postman.json