WorkSignal MCP Server

Hire from your terminal. Post jobs, screen candidates with AI voice interviews, and manage your entire hiring pipeline from Claude Code, Cursor, or any MCP-compatible tool.

WorkSignal is a hiring platform built for tech founders and small teams. No clunky ATS UI - just post a role, AI screens every applicant with a voice call, and you get a ranked shortlist. Connect via MCP and you never leave your editor.

Why

• You're a founder. You posted a job. You got 200 applications.
• 90% are AI-generated spam. You don't have time to read them.
• WorkSignal screens every applicant with a 10-minute AI voice call.
• You get a shortlist with transcripts, scores, and red flags.
• From your terminal: "show me candidates who passed screening"

Quick Start

# 1. Sign up at worksignal.com (free tier, 1 minute)
# 2. Create an API key in Settings
# 3. Connect to Claude Code:

claude mcp add --transport stdio \
  --env WORKSIGNAL_API_KEY=ws_your_key_here \
  worksignal -- npx -y @worksignal/mcp-server

# 4. Start hiring:
# "Post a senior engineer role on WorkSignal"

Other Tools

Cursor:

cursor mcp add worksignal "npx -y @worksignal/mcp-server" \
  -e WORKSIGNAL_API_KEY=ws_your_key_here

Codex / opencode / Goose - add to your mcp.json:

{
  "worksignal": {
    "command": "npx",
    "args": ["-y", "@worksignal/mcp-server"],
    "env": { "WORKSIGNAL_API_KEY": "ws_your_key_here" }
  }
}

What You Can Do (24 Tools)

Post & Manage Roles

| Tool | What it does | |------|-------------| | quick_post | Create a role and publish a job posting in one step | | create_role | Create a new draft role | | publish_role | Publish a draft role | | pause_role | Pause hiring for a role | | list_roles | List all roles (filter by status) | | get_role | Role details with description and salary | | get_role_stats | Pipeline stats: applicants, scores, pass rate |

Candidates

| Tool | What it does | |------|-------------| | list_candidates | List candidates (filter by role, pipeline stage) | | get_candidate | Full detail with applications and screening results | | add_candidate | Add a referral, optionally apply to a role | | advance_candidate | Move to next pipeline stage | | reject_candidate | Reject with reason | | hire_candidate | Mark as hired | | invite_candidate_to_screen | Trigger an AI voice screening call |

Voice Screens

| Tool | What it does | |------|-------------| | list_voice_screens | List results with scores and recommendations | | get_voice_screen | Full transcript, AI analysis, red flags, and scores |

Job Postings

| Tool | What it does | |------|-------------| | list_job_postings | List postings on your career page | | update_job_posting | Update description or requirements | | unpublish_job_posting | Take a posting offline |

Social Channels (X / WhatsApp)

| Tool | What it does | |------|-------------| | post_job_to_x | Post a job to X with casual, professional, or urgent tone | | list_x_posts | See posts with engagement metrics | | get_channels | Channel connection status and usage |

Account

| Tool | What it does | |------|-------------| | get_organization | Plan info, limits, and current usage |

Examples

Just say what you need in natural language:

"Post a senior backend engineer role. Remote, Ruby/Rails, $150-200K."

"Show me candidates who passed screening for the frontend role."

"Add my friend Sarah ([email protected]) as a referral for DevOps."

"Post the engineer job to X with a casual tone."

"How's the backend engineer role doing?"

"Reject candidates #12 and #15 - not enough experience."

"Invite candidate #42 to a voice screen."

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | WORKSIGNAL_API_KEY | Yes | - | Your API key (starts with ws_) | | WORKSIGNAL_API_URL | No | https://worksignal.com | API base URL |

Pricing

• Free: 1 job, 10 voice screens/month, 100 API calls/day
• Starter ($49/mo): 5 jobs, metered voice, unlimited API
• Pro ($149/mo): 10 jobs, 200 voice min included, ATS integrations
• Scale ($499/mo): Unlimited jobs, dedicated support

Get started free - no credit card required to try.

Links

• WorkSignal - Main site
• API Docs - REST API reference
• Pricing - Plans and features

License

MIT