Zizai Recruitment MCP Server

Zizai Recruitment MCP Server

What is Zizai Recruitment MCP Server about?

Enables interaction with the ZIZAI Recruitment platform through a set of MCP API calls. Job seekers can fetch recommended positions and apply, while recruiters can manage their companies, post jobs, and obtain talent recommendations.

How to use Zizai Recruitment MCP Server?

1. Install the server with NPX:

{
  "mcpServers": {
    "zizaiwork": {
      "command": "npx",
      "args": ["-y", "@zizaiwork/mcp"],
      "env": { "API_KEY": "<YOUR_API_KEY>" }
    }
  }
}

2. Set the API_KEY environment variable to your ZIZAI Work API key.
3. Call the exposed functions (get-job-list, apply-for-job, get-entity-list, post-a-job, etc.) from your application or Claude Desktop configuration.

Key features

• Job seeker toolkit: retrieve job lists with filters, apply to positions.
• Recruiter toolkit: list managed entities, view posted jobs, post new jobs, fetch recommended talents.
• Field taxonomy: obtain standardized field IDs for job categorization.
• Simple NPX deployment: one‑line install, no manual build steps.
• Secure API access: operates with a personal API key passed via environment variable.

Use cases

• Build a custom job‑search chatbot that suggests positions based on user preferences.
• Integrate recruitment data into an internal HR dashboard.
• Automate bulk job posting for multiple subsidiaries of a company.
• Generate talent shortlists for specific openings using the recommendation endpoint.

FAQ

Q: Which command should I use to run the server? A: Prefer the npx command as shown in the configuration; it automatically installs and runs the package.

Q: Do I need to set any other environment variables? A: Only the API_KEY (your ZIZAI Work API key) is required.

Q: Can I filter job listings by type? A: Yes, use the optional recruitType parameter (1‑Social, 2‑Campus, 3‑Internship) when calling get-job-list.

Q: What format is the salary information returned in? A: It may be an object { minSalary, maxSalary } or a plain string, depending on the source data.

Q: Is there support for posting jobs with benefits and address? A: The post-a-job endpoint accepts optional benefit and address fields.

ZIZAI Recruitment MCP Server

MCP Server for ZIZAI Recruitment API.

ZIZAI Recruitment

ZIZAI Recruitment (https://zizai.work) is a next-generation intelligent recruitment platform based on professional assessments, enabling efficient and precise matching between talents and job positions.

Join us and experience the charm of intelligent recruitment now!

Tools

Job Seekers

1. get-job-list

   • Retrieve a list of recommended job positions
   • Input:
     • keyword (string, optional): Search keyword for job positions.
     • recruitType (number, optional): Job type, 1 - Social Recruitment, 2 - Campus Recruitment, 3 - Internship.
   • Returns:
     • Array of {
       • workPin: string
       • name: string
       • entityName: string
       • entityShortname: string
       • responsibility: string
       • requirement: string
       • welfare: string
       • salary: { minSalary: number, maxSalary: number } | string
       • detailUrl: string }

2. apply-for-job

   • Apply for a job position
   • Input:
     • workPin (string) Unique code for the job position
   • Returns:

Recruiters

1. get-entity-list

   • Retrieve a list of managed entities
   • Input:
   • Returns:
     • Array of {
       • entityPin: string
       • entityName: string
       • entityShortname: string
       • unifiedSocialCreditCode: string
       • entityLogo: string
       • detailUrl: string }

2. get-entity-jobs

   • Retrieve job positions published under an entity
   • Input:
     • entityPin (string): Unique code for the entity
   • Returns:
     • Array of {
       • workPin: string
       • name: string
       • entityPin: string
       • responsibility: string
       • requirement: string
       • welfare: string
       • salary: { minSalary: number, maxSalary: number } | string
       • detailUrl: string }

3. get-recommend-talents

   • Retrieve recommended talents for a job position
   • Input:
     • workPin (string): Unique code for the job position
   • Returns:
     • Array of {
       • userPin: string
       • birthday: string
       • university: string
       • major: string
       • highestEducation: string
       • workYears: number
       • workName: string
       • matchDegree: number }

4. get-field-list

   • Retrieve a list of fields
   • Input:
   • Returns:
     • Array of {
       • fid: number
       • name: string }

5. post-a-job

   • Post a job position
   • Input:
     • entityPin (string): Unique code for the entity
     • fid (number): Field to which the job position belongs
     • jobName (string): Name of the job position
     • responsibility (string): Job responsibilities
     • requirement (string): Job requirements
     • city (string): Job city
     • benefit (string, optional): Job benefits
     • address (string, optional): Job address
   • Returns:

Setup

API Key

Get a ZIZAI Work API key by following the instructions here.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "zaiwork": {
      "command": "npx",
      "args": [
        "-y",
        "@zizaiwork/mcp"
      ],
      "env": {
        "ZAI_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

License

This MCP server is licensed under the Apache-2.0 License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the Apache-2.0 License. For more details, please see the LICENSE file in the project repository.