Rolescout MCP Server

Use Rolescout as an MCP tool to search ATS and job boards from AI agents.

Quick facts

Package: rolescout-mcp

Tools: search_jobs, list_platforms, validate_links

Required env: SERPER_API_KEY (from serper.dev)

Install mode: npx -y rolescout-mcp

1) Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "rolescout": {
      "command": "npx",
      "args": ["-y", "rolescout-mcp"],
      "env": {
        "SERPER_API_KEY": "your_serper_api_key"
      }
    }
  }
}

2) Claude Code

Add this to your repo .mcp.json (or user-level MCP config):

{
  "mcpServers": {
    "rolescout": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "rolescout-mcp"],
      "env": {
        "SERPER_API_KEY": "your_serper_api_key"
      },
      "tools": ["*"]
    }
  }
}

3) Cursor / VS Code (MCP)

Use the same package-based MCP config:

{
  "mcpServers": {
    "rolescout": {
      "command": "npx",
      "args": ["-y", "rolescout-mcp"],
      "env": {
        "SERPER_API_KEY": "your_serper_api_key"
      }
    }
  }
}

Tool signatures

search_jobs(
  roles?: string[],
  raw_query?: string,
  filters?: string[],
  exclude_filters?: string[],
  sites?: string[],
  result_limit?: number,
  date_range?: number,
  title_only?: boolean,
  deduplicate?: boolean,
  snippet_length?: number,
  full_description?: boolean,
  include_expired?: boolean,
  output_format?: "results" | "csv" | "both"
)

list_platforms()

validate_links(
  urls: string[]
)