{
  "name": "SignalHire MCP Server",
  "description": "Model Context Protocol (MCP) server for candidate discovery, contact enrichment, and company intelligence via SignalHire.",
  "protocolVersion": "2024-11-05",
  "status": "online",
  "transports": [
    "stdio",
    "streamable-http",
    "sse"
  ],
  "endpoints": {
    "mcp": "https://signalhire.growviah.com/mcp",
    "sse": "https://signalhire.growviah.com/sse",
    "health": "https://signalhire.growviah.com/health"
  },
  "tools": [
    {
      "name": "search_candidates_query",
      "description": "Search people, find candidates, discover leads, and source talent from the SignalHire database of hundreds of millions of professionals using advanced filters (title, location, company, keywords, department, seniority level). Uses daily search quota (no contact credits)."
    },
    {
      "name": "scroll_search",
      "description": "Fetch the next batch of search results for pagination. Must be called within 15 seconds of the previous search response. Tip: Prefer using search_candidates_query with auto_paginate=true or max_results to fetch all pages in one call."
    },
    {
      "name": "retrieve_person_no_contacts",
      "description": "Retrieve a candidate's full professional profile (work history, skills, education, languages, certifications) WITHOUT unlocking contact details. Uses daily without-contacts quota and charges ZERO Contact Credits. Resets daily at 00:00 UTC."
    },
    {
      "name": "retrieve_person_profile",
      "description": "Retrieve a candidate's full profile INCLUDING contact information (verified personal/work emails, direct phone numbers, social links). ⚠️ Consumes 1 Contact Credit per successful match. Safety guardrail: Requires spend_credits_confirmed=true."
    },
    {
      "name": "find_company",
      "description": "Look up a company by name or domain to check employee presence, headcount, primary domain/website, industry, and office locations in SignalHire. Enriched data makes wrong matches easy to spot."
    },
    {
      "name": "bulk_find_company",
      "description": "Bulk search and compare multiple companies in a single call. Checks headcount in SignalHire, verified office locations, sample roles, and primary domains for up to 20 companies at once."
    },
    {
      "name": "search_companies_by_filters",
      "description": "Search companies by filters like industry (from 146 supported categories), country/location, keywords (e.g. 'Fintech', 'SaaS', 'Logistics'), and company size. Aggregates employee presence from the SignalHire database."
    },
    {
      "name": "get_company_info",
      "description": "Retrieve company firmographics and headcount. Note: If firmographics are not enabled on the account, it automatically provides talent pool analytics. To search employees directly, use search_candidates_query with current_company."
    },
    {
      "name": "check_balance",
      "description": "Check all SignalHire account balances and quotas: standard Contact Credits, daily Without-Contacts quota (with exact reset countdown), and Company Intelligence API status. Free tool."
    },
    {
      "name": "check_without_contacts_credits",
      "description": "Check the remaining daily quota for retrieving candidate profiles without contact details (retrieve_person_no_contacts). Shows exact time until midnight UTC reset."
    },
    {
      "name": "get_available_levels",
      "description": "Retrieve the complete list of candidate seniority levels supported by the SignalHire search API and their normalization rules. Free tool."
    },
    {
      "name": "get_available_departments",
      "description": "Retrieve the complete list of 15 professional departments supported by the SignalHire search API. Free tool."
    },
    {
      "name": "get_available_industries",
      "description": "Retrieve the list of 146 official supported industry categories for candidate search, with optional search filter. Free tool."
    },
    {
      "name": "export_to_csv",
      "description": "Export candidate or company search results into CSV format or Google Sheets / Excel copy-pasteable TSV format. Can export provided items or run search_params and export directly."
    }
  ],
  "usage": {
    "auth": "Provide 'Authorization: Bearer <YOUR_SIGNALHIRE_API_KEY>' in headers",
    "cursorOrWindsurf": {
      "type": "http",
      "url": "https://signalhire.growviah.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SIGNALHIRE_API_KEY"
      }
    },
    "claudeDesktop": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://signalhire.growviah.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_SIGNALHIRE_API_KEY"
      ]
    },
    "claudeAiCustomConnector": {
      "url": "https://signalhire.growviah.com/mcp"
    },
    "n8n": {
      "transport": "HTTP Streamable",
      "url": "https://signalhire.growviah.com/mcp",
      "auth": "Bearer Auth"
    }
  }
}