# Coresignal — how to use (mcp.ai)

Connect your Coresignal account and use 3 tools for web scraping straight from your AI agent. Connect with your own API key. Coresignal provides agentic search and real-time employee data from public web sources for research, recruiting, and sales workflows.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_coresignal?ms=1787291340000`
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. `coresignal_get_real_time_employee_profile`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/coresignal`
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/coresignal/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/coresignal/get/real/time/employee/profile` — Retrieve an employee profile, using cached data up to max_age hours old (24 by default); set max_age=0 to request current data. Requires the connected account's separate Real-time Employee API entitle
  - body: { url: string, max_age?: number }
- `POST https://api.mcp.ai/api/coresignal/search/fast` — Turn a natural-language employee, company, or job search into an Elasticsearch query, or return matching preview records. Prefer this lower-cost search unless deeper reasoning or clarification is need
  - body: { limit?: integer, entity?: string, prompt: string, threshold?: number, return_data?: boolean }
- `POST https://api.mcp.ai/api/coresignal/search/with/reasoning` — Run a higher-cost natural-language search that explains its interpretation and can request clarification. Use when fast search is ambiguous or reasoning is valuable; a query-mode call consumed 100 tri
  - body: { limit?: integer, prompt: string, threshold?: number, session_id: string, return_data?: boolean, allow_clarification?: boolean }

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

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