Dice MCP Server

Overview

The Dice MCP Server provides AI assistants with programmatic access to job listings through the Model Context Protocol (MCP). This service enables AI applications to search for jobs with comprehensive filtering options and return structured results.

Key Features

  • Real-time job search capabilities
  • Advanced filtering (location, remote work, employment type, etc.)

Server URL

Production Endpoint: https://mcp.dice.com/mcp

Getting Started

Prerequisites

  • An MCP-compatible client (Claude Code, Claude Desktop, or custom MCP client)
  • Basic understanding of the Model Context Protocol

Quick Setup

This remote MCP server can be accessed directly via its URL. No authentication is required for basic usage. Connect with a MCP client of your choice.

Claude Code MCP Documentation

Visual Studio Code MCP Servers

Strands Agents MCP Tools

Use Claude Desktop Connector

Look for Dice in the list of available MCP servers within Claude Desktop.
Claude Desktop Connector

Use ChatGPT Custom Connector

Add Dice MCP as a ChatGPT custom connector.
ChatGPT Custom Connector

Available Tools

search_jobs

Search for job listings using keywords and optional filters.

Parameters

Parameter Type Required Description
keyword string Yes Job title or keywords to search for
location string No Geographic location (e.g., "San Francisco, CA")
radius number No Search radius from location (minimum: 1.0)
radius_unit string No Unit for radius: "mi", "km", "miles", or "kilometers"
jobs_per_page integer No Number of results per page (range: 1-100)
page_number integer No Page number for pagination (default: 1)
posted_date string No Filter by recency: "ONE" (1 day), "THREE" (3 days), or "SEVEN" (7 days)
workplace_types array[string] No Options: "Remote", "On-Site", "Hybrid"
employment_types array[string] No Options: "FULLTIME", "CONTRACTS", "PARTTIME", "THIRD_PARTY"
employer_types array[string] No Options: "Direct Hire", "Recruiter", "Other"
willing_to_sponsor boolean No Filter for employers willing to sponsor work authorization
easy_apply boolean No Filter for jobs with simplified application process
fields array[string] No Specific fields to include in response (returns all by default)

Response Format

The tool returns a structured JSON response containing:

{
  "data": [
    {
      "id": "unique-job-id",
      "title": "Senior Software Engineer",
      "summary": "Job description text...",
      "companyName": "Example Tech Company",
      "jobLocation": {
        "displayName": "San Francisco, CA"
      },
      "detailsPageUrl": "https://www.dice.com/job-detail/...",
      "companyPageUrl": "https://www.dice.com/company/...",
      "salary": "$120,000 - $150,000",
      "employmentType": "FULLTIME",
      "workplaceTypes": ["Remote", "Hybrid"],
      "postedDate": "2025-10-20T12:00:00Z",
      "willingToSponsor": true,
      "easyApply": true
    }
  ],
  "meta": {
    "currentPage": 1,
    "pageCount": 10,
    "pageSize": 25,
    "totalResults": 250
  },
  "_links": {
    "next": { "href": "/search?page=2" },
    "last": { "href": "/search?page=10" }
  }
}

Response Fields

Job Data Fields:

  • id - Unique job identifier
  • title - Job title
  • summary - Job description
  • companyName - Hiring company name
  • jobLocation.displayName - Job location
  • detailsPageUrl - Link to full job posting
  • companyPageUrl - Link to company profile
  • companyLogoUrl - Company logo image URL
  • salary - Salary information (if available)
  • employmentType - Type of employment
  • workplaceTypes - Workplace arrangements (Remote, On-Site, Hybrid)
  • postedDate - When the job was posted
  • modifiedDate - When the job was last updated
  • willingToSponsor - Visa sponsorship availability
  • easyApply - Simplified application available
  • isRemote - Fully remote position indicator

Metadata Fields:

  • currentPage - Current page number
  • pageCount - Total number of pages
  • pageSize - Results per page
  • totalResults - Total matching jobs

Example Usage

Basic Search:

{
  "keyword": "Python Developer"
}

Advanced Search with Filters:

{
  "keyword": "Data Scientist",
  "location": "New York, NY",
  "radius": 25,
  "radius_unit": "miles",
  "workplace_types": ["Remote", "Hybrid"],
  "employment_types": ["FULLTIME"],
  "posted_date": "SEVEN",
  "willing_to_sponsor": true
}

Pagination:

{
  "keyword": "Software Engineer",
  "jobs_per_page": 50,
  "page_number": 2
}

Troubleshooting

Connection Issues

Problem: Cannot connect to the MCP server

Solutions:

  1. Verify the URL is correct: https://mcp.dice.com/mcp
  2. Check your internet connection
  3. Ensure your MCP client configuration is correct
  4. Restart your MCP client after configuration changes

Rate Limiting

Problem: Receiving HTTP 429 errors

Solutions:

  1. Reduce request frequency
  2. Implement exponential backoff (wait 1s, 2s, 4s, etc.)
  3. Cache results to reduce duplicate requests

Invalid Parameters

Problem: Tool returns validation errors

Solutions:

  1. Verify the keyword parameter is provided (required)
  2. Check that numeric parameters are within valid ranges:
    • radius must be ≥ 1.0
    • jobs_per_page must be between 1-100
    • page_number must be ≥ 1
  3. Ensure enum values match exactly (case-sensitive):
    • workplace_types: "Remote", "On-Site", "Hybrid"
    • employment_types: "FULLTIME", "CONTRACTS", "PARTTIME", "THIRD_PARTY"
    • posted_date: "ONE", "THREE", "SEVEN"

Empty Results

Problem: Search returns no jobs

Solutions:

  1. Try broader search terms
  2. Remove or relax filters (location, workplace_types, etc.)
  3. Increase the search radius
  4. Remove the posted_date filter for older listings

Best Practices

Search Optimization

  1. Start Broad: Begin with general keywords, then refine with filters
  2. Use Location Wisely: Combine city searches with radius for better coverage
  3. Leverage Filters: Use workplace_types and employment_types to narrow results
  4. Check Recent Listings: Use posted_date to focus on active opportunities
  5. Paginate Results: Request reasonable page sizes (25-50) for better performance

Example Prompts

These example prompts demonstrate how to use the Dice MCP Server through an AI assistant:

Basic Searches

  • "Find Python developer jobs"
  • "Search for software engineer positions"
  • "Show me data scientist roles"

Location-Based Searches

  • "Find remote software engineer jobs"
  • "Search for jobs in San Francisco, California"
  • "Show me data analyst positions within 50 miles of Austin, Texas"

Filtered Searches

  • "Find full-time Python developer jobs posted in the last week"
  • "Search for remote data scientist positions that offer visa sponsorship"
  • "Show me contract software engineer roles in Seattle"

Advanced Searches

  • "Find hybrid product manager jobs in New York with easy apply"
  • "Search for full-time Java developer positions in Dallas that offer sponsorship"
  • "Show me the next page of results for software engineer jobs"

Support

For technical support, questions, or to report issues:

Contact Support

Changelog

Version 1.0.0: Initial Release 11/04/2025
Loading...