> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dice MCP

> Search Dice's tech-job database with conversational filters for role, company, location, and employment type.

![Dice MCP logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/dice_mcp.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=05815bef39c7f43138b44d61954fe1d2)

* **Category:** hr talent & recruitment
* **Auth:** NO\_AUTH
* **Composio-managed OAuth available?** N/A
* **Tools:** 3
* **Triggers:** 0
* **Slug:** `DICE_MCP`
* **Version:** 20261018\_00

## Tools

> [accordion] Get company
>
> **Slug:** `DICE_MCP_GET_COMPANY`
>
> Retrieve the name and description of the company behind a job, by job ID.
>
> Use this tool when users want more detail about a company than search\_jobs/get\_job\_details return (e.g. after finding a job and wanting to know more about the company that posted it). DO NOT use for: searching/discovering companies or jobs by keyword (use search\_jobs instead).
>
> LLM USAGE INSTRUCTIONS:
>
> * The typical flow is: search\_jobs to find jobs -> user picks one -> offer to look up the company -> if the user agrees, call this tool with that same job\_id (the same guid used for get\_job\_details; no separate lookup step is needed first).
> * Do not call this automatically right after get\_job\_details; ask the user first unless they already explicitly asked for company details.
> * Not every company has published an employer branding profile, and some profiles are marked not visible by the company. When that happens this tool does NOT raise — it returns a Company with `message` set and empty name/desc. Relay that message to the user (e.g. "Looks like that company hasn't published a public profile.") rather than treating it as an error.
>
> Args: job\_id: The unique identifier of the job whose company to look up (required). This must be the job's `guid` field from a search\_jobs result, NOT its `id` field — `id` is a different, internal identifier that this tool does not accept.
>
> Returns: Company: Contains:
>
> * name: The company name (empty if message is set)
> * desc: The company description (empty if message is set)
> * message: Set instead of name/desc when there is no visible company profile to show; None when name/desc are populated
>
> Raises: Exception: If the job is not found, an API call itself fails (network error, non-200 response, GraphQL errors), or input validation errors occur
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> #### Output
>
> **desc** `string`
>
> The company description
>
> **name** `string`
>
> The company name
>
> **message** `string`
>
> Set instead of name/desc when there is no visible company profile to show (e.g. the company hasn't published one, or has marked it not visible). None when name/desc are populated.

> [accordion] Get job details
>
> **Slug:** `DICE_MCP_GET_JOB_DETAILS`
>
> Retrieve a job's full description and associated skills by job ID.
>
> Use this tool when users want more detail about a specific job than search\_jobs returns (e.g. after finding a job via search\_jobs and wanting its full description and skills list). DO NOT use for: searching/discovering jobs by keyword (use search\_jobs instead).
>
> LLM USAGE INSTRUCTIONS:
>
> * Only call this after the user has picked out a specific job from search\_jobs results (or otherwise supplied a job's guid directly) — do not call it speculatively for every search result.
> * After returning job details, do NOT automatically call get\_company. Instead, offer to look up the company (e.g. "Want me to pull up more info on the company?") and only call get\_company, passing this same job\_id, if the user says yes.
>
> Args: job\_id: The unique identifier of the job to retrieve (required). This must be the job's `guid` field from a search\_jobs result, NOT its `id` field — `id` is a different, internal identifier that this tool does not accept.
>
> Returns: JobDetails: Contains:
>
> * description: The full job description
> * skills: List of Skill objects associated with the job
>
> Raises: Exception: If the API call fails, the job is not found, or input validation errors occur
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> #### Output
>
> **skills** `array`
>
> Skills associated with the job
>
> **description** `string`
>
> The job description

> [accordion] Search jobs
>
> **Slug:** `DICE_MCP_SEARCH_JOBS`
>
> Search for job listings by keyword, location, and filters. Returns job details, company info, and application links.
>
> Use this tool when users want to find jobs, search employment opportunities, or explore job openings. DO NOT use for: applying to jobs, submitting applications, or making employment decisions.
>
> LLM USAGE INSTRUCTIONS:
>
> * ALWAYS provide the keyword parameter (required)
> * When presenting results to users, include BOTH the job details URL (detailsPageUrl) AND the company page URL (companyPageUrl) for each job
> * Use location to find geographically relevant positions
> * Combine filters to refine searches (e.g., workplace\_types=\['Remote'] for remote work)
> * Use posted\_date to find recent openings ('ONE'=1 day, 'THREE'=3 days, 'SEVEN'=7 days)
> * Default jobs\_per\_page is reasonable, increase for comprehensive searches
> * Use company\_name to scope results to a specific employer
> * Use sort='datePosted' when the user wants the newest listings instead of the most relevant
> * Use facets to get aggregate counts (e.g., how many results are remote vs on-site) without paging through all results
> * After presenting results, do NOT automatically call get\_job\_details for every job returned. Wait for the user to indicate which specific job(s) they're interested in, then pass that job's guid to get\_job\_details.
>
> IMPORTANT - AI DISCLOSURE REQUIREMENT: When presenting job search results to users, you MUST include an appropriate disclosure that these results were retrieved using AI assistance. Example disclosure language: "These job listings were found using AI-powered search. Please review all job details carefully and verify information directly with employers before applying."
>
> This tool provides job listing data only. Final employment decisions should always involve human judgment and direct review of complete job postings.
>
> Args: keyword: The job keyword or title to search for (required) location: Geographic location for the job search (city, state, country) radius: Search radius from the specified location (minimum 1, requires radius\_unit) radius\_unit: Unit for search radius. Options: 'mi', 'km' (requires radius) jobs\_per\_page: Number of jobs to return per page (1-100, defaults to 5) page\_number: Page number for pagination (1-based, default is 1) sort: Sort order for results. Options: 'relevance', 'datePosted' (defaults to relevance) posted\_date: Filter by posting date. Options: 'ONE' (1 day), 'THREE' (3 days), 'SEVEN' (7 days) workplace\_types: Workplace arrangements. Options: 'Remote', 'On-Site', 'Hybrid' employment\_types: Employment types. Options: 'FULLTIME', 'CONTRACTS', 'PARTTIME', 'THIRD\_PARTY', 'INTERNSHIP' employer\_types: Employer types. Options: 'Direct Hire', 'Recruiter', 'Other' willing\_to\_sponsor: Filter for employers willing to sponsor work authorization (boolean) easy\_apply: Filter for jobs with easy application process (boolean) company\_name: Filter by company name fields: Specific fields to include in response (optional, returns all exposed fields by default) facets: Facet dimensions to aggregate (optional). Options: 'employmentType', 'postedDate', 'workFromHomeAvailability', 'workplaceTypes', 'employerType', 'easyApply', 'isRemote', 'willingToSponsor'
>
> Returns: JobSearchResult: Contains:
>
> * data: List of JobDisplayFields with job details including:
>   * guid: The job's identifier to pass as job\_id to get\_job\_details for the full description and skills list (NOT the `id` field, which is a different, internal identifier not accepted by get\_job\_details)
>   * detailsPageUrl: Direct link to full job posting
>   * companyPageUrl: Link to company profile page
>   * title, summary, salary, location, employmentType, etc.
> * metadata: Search metadata with pagination info and facet results
>
> Raises: Exception: If API call fails or input validation errors occur
>
> #### Input Parameters
>
> **sort** `string`
>
> **facets** `array`
>
> **fields** `array`
>
> **radius** `integer`
>
> **keyword** `string` *required*
>
> **location** `string`
>
> **easy\_apply** `boolean`
>
> **page\_number** `integer`
>
> **posted\_date** `string`
>
> **radius\_unit** `string`
>
> **company\_name** `string`
>
> **jobs\_per\_page** `integer`
>
> **employer\_types** `array`
>
> **workplace\_types** `array`
>
> **employment\_types** `array`
>
> **willing\_to\_sponsor** `boolean`
>
> #### Output
>
> **data** `string`
>
> Array of job listings matching the search criteria
>
> **metadata** `string`
>
> Metadata about the search results and pagination
