{"_id":"@100hires/mcp-server","_rev":"5-9acda0a83e1a31e76786cf320b637a1c","name":"@100hires/mcp-server","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@100hires/mcp-server","version":"1.0.0","keywords":["mcp","100hires","ats","recruiting","hiring"],"license":"MIT","_id":"@100hires/mcp-server@1.0.0","maintainers":[{"name":"zhandos90","email":"zhandos@100hires.com"}],"homepage":"https://github.com/100Hires/mcp-server#readme","bugs":{"url":"https://github.com/100Hires/mcp-server/issues"},"bin":{"mcp-server":"build/index.js"},"dist":{"shasum":"6666c118393f38da29c6ef6c5d59007ddaead2f9","tarball":"https://registry.npmjs.org/@100hires/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":20,"integrity":"sha512-2sBw3SiBBt/S/iWpgimLdqK9vY4bichO+oI0bSkSGC60BvQcQI3czTTMAduUjMgboblYCeo5C6i4gWS63YIIzA==","signatures":[{"sig":"MEUCIB0DmnJBBWBvzcpSfeAdEW85h8eo9TegUhW8i4gXHrM9AiEArdfZRFRwWpJi9+JGHGRhqGLY+A7X2rxthy/A//IakTw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":162073},"type":"module","gitHead":"0bb751152bdfb3c6bc2089536c28895996e60dc7","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"zhandos90","email":"zhandos@100hires.com"},"repository":{"url":"git+https://github.com/100Hires/mcp-server.git","type":"git"},"_npmVersion":"11.9.0","description":"Official MCP server for 100Hires ATS — exposes the full recruiting API as MCP tools","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.24.2","axios":"^1.8.3","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1776280859815_0.6677121022978783","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"1.0.2":{"name":"@100hires/mcp-server","version":"1.0.2","keywords":["mcp","100hires","ats","recruiting","hiring"],"license":"MIT","_id":"@100hires/mcp-server@1.0.2","maintainers":[{"name":"zhandos90","email":"zhandos@100hires.com"}],"homepage":"https://github.com/100Hires/mcp-server#readme","bugs":{"url":"https://github.com/100Hires/mcp-server/issues"},"bin":{"mcp-server":"build/index.js"},"dist":{"shasum":"7bc90bf6551248a1a04b13a2ce87fe1d003b45f6","tarball":"https://registry.npmjs.org/@100hires/mcp-server/-/mcp-server-1.0.2.tgz","fileCount":21,"integrity":"sha512-B3Sh5u9qNwKUQd27RX8JQ69jtjnI5j/EAB4Xoqi4Rtx/Pg8n1lp2ajIXEZylMMrJBe2IG/EF1u6KdVZQVDJukQ==","signatures":[{"sig":"MEYCIQD1F9EaXJxhElGhwyg98BoAP2sOv/9X59yKk4DsG8zRZAIhAPcSmKbkKgWU7v3Id4oO4h6FrZ056GosPVwO63IgICPD","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":166145},"type":"module","gitHead":"fb89794c35e4e1079e14543a147ca90d61419671","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"zhandos90","email":"zhandos@100hires.com"},"repository":{"url":"git+https://github.com/100Hires/mcp-server.git","type":"git"},"_npmVersion":"11.9.0","description":"Official MCP server for 100Hires ATS — exposes the full recruiting API as MCP tools","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.24.2","axios":"^1.8.3","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.2_1776291598337_0.5272542390736852","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"1.0.3":{"name":"@100hires/mcp-server","version":"1.0.3","keywords":["mcp","100hires","ats","recruiting","hiring"],"license":"MIT","_id":"@100hires/mcp-server@1.0.3","maintainers":[{"name":"zhandos90","email":"zhandos@100hires.com"}],"homepage":"https://github.com/100Hires/mcp-server#readme","bugs":{"url":"https://github.com/100Hires/mcp-server/issues"},"bin":{"mcp-server":"build/index.js"},"dist":{"shasum":"1f8afe56dc5aa8f7956e002bb95682ae5b817a2b","tarball":"https://registry.npmjs.org/@100hires/mcp-server/-/mcp-server-1.0.3.tgz","fileCount":22,"integrity":"sha512-r3wwth+kbZBAmaEI/zWKysU+KXk8oxMSYdtnqASOxA6bioD4wc+RXfg/WLotJFGYbRFshRijyI99hOeI9ad8QQ==","signatures":[{"sig":"MEYCIQCsmjhfmoCwh08Rj5OMx7DkJhT6RQ2i/ZQeQy8HfRttyAIhAKkWDkZQhndQ6cl3aFlD4JbFDjJWFEIO3nnKdiV5SCV0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":168279},"type":"module","gitHead":"37886695a928502011fffe8962ab526e24dd6ff3","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"zhandos90","email":"zhandos@100hires.com"},"repository":{"url":"git+https://github.com/100Hires/mcp-server.git","type":"git"},"_npmVersion":"11.9.0","description":"Official MCP server for 100Hires ATS — exposes the full recruiting API as MCP tools","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.24.2","axios":"^1.8.3","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.3_1776429754764_0.5152418533598941","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"1.0.4":{"name":"@100hires/mcp-server","version":"1.0.4","keywords":["mcp","100hires","ats","recruiting","hiring"],"license":"MIT","_id":"@100hires/mcp-server@1.0.4","maintainers":[{"name":"zhandos90","email":"zhandos@100hires.com"}],"homepage":"https://github.com/100Hires/mcp-server#readme","bugs":{"url":"https://github.com/100Hires/mcp-server/issues"},"bin":{"mcp-server":"build/index.js"},"dist":{"shasum":"c8126942149735b059aaa733f466601b5c2c2d7c","tarball":"https://registry.npmjs.org/@100hires/mcp-server/-/mcp-server-1.0.4.tgz","fileCount":23,"integrity":"sha512-DydVLFcCC7pTjk4xPunDPAbMxDwTn1NqXNsdcxvp36vVepK22g6OvqI3htKmVboqya664K1woNDh21j2Yh/nUg==","signatures":[{"sig":"MEUCIGF0UBJ8dfueZjUFQ3mq7Bt56gGQUH1Vgrmp5B0jzRXOAiEAyNkVOvM0nwEOSAUOcpzh/23yFH/K522qwUYI3Kc5hzQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":176067},"type":"module","gitHead":"5faa08e82ef1c61866855b29dcbbd4305d36528a","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"zhandos90","email":"zhandos@100hires.com"},"repository":{"url":"git+https://github.com/100Hires/mcp-server.git","type":"git"},"_npmVersion":"11.9.0","description":"Official MCP server for 100Hires ATS — exposes the full recruiting API as MCP tools","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.24.2","axios":"^1.8.3","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.4_1776518260439_0.09682359104694971","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."}},"time":{"created":"2026-04-15T19:20:59.651Z","modified":"2026-05-09T14:54:38.222Z","1.0.0":"2026-04-15T19:20:59.956Z","1.0.2":"2026-04-15T22:19:58.494Z","1.0.3":"2026-04-17T12:42:34.938Z","1.0.4":"2026-04-18T13:17:40.807Z"},"bugs":{"url":"https://github.com/100Hires/mcp-server/issues"},"license":"MIT","homepage":"https://github.com/100Hires/mcp-server#readme","keywords":["mcp","100hires","ats","recruiting","hiring"],"repository":{"url":"git+https://github.com/100Hires/mcp-server.git","type":"git"},"description":"Official MCP server for 100Hires ATS — exposes the full recruiting API as MCP tools","maintainers":[{"name":"zhandos90","email":"zhandos@100hires.com"}],"readme":"# 100Hires MCP Server\n\nOfficial [Model Context Protocol](https://modelcontextprotocol.io/) server for [100Hires](https://100hires.com) — the applicant tracking system for recruiting teams.\n\nExposes the full [100Hires API v2](https://100hires.com/api) as **130 MCP tools**, enabling AI assistants to manage candidates, jobs, applications, interviews, messages, and more.\n\n## Prerequisites\n\nGet your API key at [Settings > Integrations > API](https://app.100hires.com/settings/integrations#api_key_integration).\n\n## Setup\n\n### Claude Code\n\nRun in your terminal:\n\n```bash\nclaude mcp add 100hires \\\n  -e API_KEY=your-api-key \\\n  -- npx -y @100hires/mcp-server\n```\n\n### Claude Code (manual)\n\nAdd to your project's `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"100hires\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@100hires/mcp-server\"],\n      \"env\": {\n        \"API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nOpen **Settings > MCP** and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"100hires\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@100hires/mcp-server\"],\n      \"env\": {\n        \"API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nOpen **Settings > MCP** and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"100hires\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@100hires/mcp-server\"],\n      \"env\": {\n        \"API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### VS Code (Copilot)\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"100hires\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@100hires/mcp-server\"],\n      \"env\": {\n        \"API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Tools (130)\n\n### Candidates (18 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_candidates` | List candidates with filters (job, stage, email, search, linkedin, timestamps) |\n| `hires_create_candidate` | Create a new candidate with profile data |\n| `hires_get_candidate` | Get candidate by ID or alias |\n| `hires_update_candidate` | Update candidate fields |\n| `hires_delete_candidate` | Delete a candidate |\n| `hires_list_candidate_tags` | List candidate's tags |\n| `hires_add_candidate_tags` | Attach tags to a candidate |\n| `hires_remove_candidate_tag` | Remove a specific tag |\n| `hires_batch_add_tags` | Bulk add tags to multiple candidates |\n| `hires_batch_remove_tags` | Bulk remove tags from multiple candidates |\n| `hires_list_candidate_files` | List candidate attachments |\n| `hires_upload_candidate_file` | Upload a file (base64) |\n| `hires_get_candidate_resume` | Get resume with optional text content |\n| `hires_list_candidate_activities` | Get candidate timeline |\n| `hires_disqualify_candidate` | Reject all active applications |\n| `hires_list_candidate_interviews` | List candidate's interviews |\n| `hires_list_candidate_messages` | List email history |\n| `hires_send_candidate_message` | Schedule an email |\n\n### Applications (18 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_applications` | List applications with filters (candidate, job, stage, status, AI score) |\n| `hires_create_application` | Link candidate to job |\n| `hires_get_application` | Get application details |\n| `hires_update_application` | Update application fields |\n| `hires_delete_application` | Delete an application |\n| `hires_move_application` | Move to a specific pipeline stage |\n| `hires_advance_application` | Advance to the next stage |\n| `hires_hire_application` | Mark as hired |\n| `hires_reject_application` | Reject with optional reason |\n| `hires_unreject_application` | Undo rejection |\n| `hires_transfer_application` | Transfer to another job |\n| `hires_get_ai_score` | Get AI scoring breakdown |\n| `hires_list_application_attachments` | List attachments |\n| `hires_upload_application_attachment` | Upload attachment |\n| `hires_list_application_evaluations` | List filled evaluations |\n| `hires_create_interview` | Schedule interview for application |\n| `hires_batch_move_applications` | Bulk move to stage |\n| `hires_batch_reject_applications` | Bulk reject |\n\n### Jobs (17 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_jobs` | List jobs with filters |\n| `hires_create_job` | Create a job |\n| `hires_get_job` | Get job by ID or alias |\n| `hires_update_job` | Update job fields |\n| `hires_delete_job` | Delete a job |\n| `hires_set_job_status` | Change status (publish/archive/close) |\n| `hires_list_job_boards` | List available job boards |\n| `hires_publish_to_job_board` | Publish to a board |\n| `hires_remove_from_job_board` | Remove from a board |\n| `hires_batch_job_boards` | Get batch job board status |\n| `hires_batch_publish_to_boards` | Publish to multiple boards |\n| `hires_batch_remove_from_boards` | Remove from multiple boards |\n| `hires_list_hiring_team` | List hiring team members |\n| `hires_add_hiring_team_member` | Add hiring team member |\n| `hires_list_job_webhooks` | List job webhooks |\n| `hires_create_job_webhook` | Register a job webhook |\n| `hires_delete_job_webhook` | Delete a job webhook |\n\n### Messages (6 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_messages` | List messages by mail account |\n| `hires_get_message` | Get a scheduled message |\n| `hires_update_message` | Full update of scheduled message |\n| `hires_patch_message` | Partial update of scheduled message |\n| `hires_delete_message` | Cancel a scheduled message |\n| `hires_batch_create_messages` | Batch schedule up to 100 messages |\n\n### Notification Messages (4 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_get_notification_message` | Get a notification email (e.g. rejection) by ID |\n| `hires_update_notification_message` | Update subject, body, reschedule send time |\n| `hires_delete_notification_message` | Cancel a scheduled notification |\n| `hires_cancel_all_notification_messages` | Cancel all scheduled notifications for a candidate |\n\n### Interviews (2 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_interviews` | List interviews with filters |\n| `hires_get_interview` | Get interview details |\n\n### Notes (5 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_notes` | List candidate notes |\n| `hires_create_note` | Create a note |\n| `hires_get_note` | Get note details |\n| `hires_update_note` | Update a note |\n| `hires_delete_note` | Delete a note |\n\n### Evaluations (1 tool)\n\n| Tool | Description |\n|------|-------------|\n| `hires_get_evaluation` | Get evaluation form with answers |\n\n### Forms (6 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_forms` | List application forms |\n| `hires_create_form` | Create an application form |\n| `hires_get_form` | Get form definition |\n| `hires_update_form` | Update a form |\n| `hires_delete_form` | Delete a form |\n| `hires_update_form_question` | Update question visibility on a form |\n\n### Email Templates (5 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_email_templates` | List email templates |\n| `hires_create_email_template` | Create a template |\n| `hires_get_email_template` | Get template details |\n| `hires_update_email_template` | Update a template |\n| `hires_delete_email_template` | Delete a template |\n\n### Nurture Campaigns (5 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_nurture_campaigns` | List campaigns |\n| `hires_create_nurture_campaign` | Create multi-step campaign |\n| `hires_get_nurture_campaign` | Get campaign details |\n| `hires_update_nurture_campaign` | Update a campaign |\n| `hires_delete_nurture_campaign` | Delete a campaign |\n\n### Users (3 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_users` | List company users |\n| `hires_get_user` | Get user details |\n| `hires_list_user_mail_accounts` | List user's mail accounts |\n\n### Companies (11 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_companies` | List accessible companies |\n| `hires_create_company` | Create a company |\n| `hires_get_company` | Get company details |\n| `hires_update_company` | Update company |\n| `hires_delete_company` | Delete a company |\n| `hires_list_company_mail_accounts` | List company mail accounts |\n| `hires_list_company_id_mail_accounts` | List mail accounts for specific company |\n| `hires_restore_company` | Restore deleted company |\n| `hires_list_webhooks` | List company webhooks |\n| `hires_create_webhook` | Register a webhook |\n| `hires_delete_webhook` | Delete a webhook |\n\n### Taxonomy & Reference (23 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_sources` | Candidate sources (LinkedIn, Referral, etc.) |\n| `hires_list_origins` | Candidate origins |\n| `hires_list_rejection_reasons` | Rejection reason dictionary |\n| `hires_list_statuses` | Job/application statuses |\n| `hires_list_departments` | Company departments |\n| `hires_list_categories` | Job categories |\n| `hires_list_education_levels` | Education levels |\n| `hires_list_experience_levels` | Experience levels |\n| `hires_list_employment_types` | Employment types |\n| `hires_list_boards` | Available job boards |\n| `hires_list_tags` | All tags |\n| `hires_list_workflows` | Hiring workflows |\n| `hires_list_workflow_stages` | All pipeline stages |\n| `hires_get_workflow_stages` | Stages for specific workflow |\n| `hires_list_questions` | Reusable questions |\n| `hires_create_question` | Create a question |\n| `hires_get_question` | Get question details |\n| `hires_update_question` | Update a question |\n| `hires_delete_question` | Delete a question |\n| `hires_list_question_types` | Available question types |\n| `hires_list_template_placeholders` | Email template placeholders |\n| `hires_prepare_template_placeholders` | Render placeholders |\n| `hires_get_billing` | Check account pricing/features |\n\n### Attachments (2 tools)\n\n| Tool | Description |\n|------|-------------|\n| `hires_download_attachment` | Download an attachment by absolute URL (resume, candidate file, application file, mail attachment, call recording). Returns base64-encoded bytes + metadata. 25 MB limit. |\n| `hires_upload_attachment` | Upload a file as `voicemail`/`candidate`/`application` attachment. Voicemail upload produces a uuid usable as `attachment_uuid` in nurture-campaign voicemail steps. |\n\n### Feedback (1 tool)\n\n| Tool | Description |\n|------|-------------|\n| `hires_submit_feedback` | Submit structured API feedback about issues or improvements |\n\n### Career Site (3 tools, public)\n\n| Tool | Description |\n|------|-------------|\n| `hires_list_career_jobs` | Public job openings |\n| `hires_get_career_job` | Get public job details |\n| `hires_submit_career_application` | Submit application via career site |\n\n> Career site tools use `company_slug` instead of API key authentication.\n\n## API Documentation\n\n- [100Hires API Docs](https://100hires.com/api)\n- [OpenAPI Spec](https://api.100hires.com/v2/openapi.json)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}