ZIZAI Recruitment

You can run the ZIZAI Recruitment MCP Server to expose the ZIZAI Recruitment API for use by MCP clients. This server lets you browse job listings, apply for jobs, and manage entities and fields through a consistent, scriptable interface during your integration workflows.

How to use

You interact with the MCP server through your MCP client by calling the available endpoints as you would with any API extension. You can retrieve recommended job listings, apply for jobs, manage entities, and fetch field lists from ZIZAI Recruitment. Each operation corresponds to a specific tool exposed by the MCP server, and you provide inputs such as keywords, entity pins, or job pins to filter and target the data you need.

Typical usage patterns include searching for jobs with a keyword and recruitment type, listing entities you manage, and then posting or querying jobs for those entities. You can also fetch recommended talents for a given job to support candidate shortlisting. Use the results to power your own UI or automation workflows in your application.

How to install

Prerequisites you need before installing: Node.js installed on your machine (recommended version 14.x or newer) and npm or yarn as your package manager. You also need a ZIZAI Work API key to access the recruitment data.

Install and run the MCP server using NPX. The following configuration runs the MCP server via NPX and passes your API key through an environment variable.

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

Additional notes

Obtain your ZIZAI Work API key from the designated access channel and keep it secure. When you run the MCP server, ensure the key is supplied in the environment as shown above. The server will expose tools for job listing, job application, entity management, field retrieval, and talent matching as described in the tools section.

Configuration and usage notes

The MCP server is licensed under the Apache-2.0 License. You can modify and adapt the server to fit your integration needs, provided you comply with the license terms. When integrating, structure your calls around the available tools to fetch job lists, apply for positions, manage entities, and retrieve field data.

Troubleshooting

If you encounter authentication errors, verify that your ZAI_API_KEY is correctly set in the environment. Double-check that the key is active and has the necessary permissions for the ZIZAI Recruitment API. If you see network or endpoint errors, confirm that network access to the ZIZAI Recruitment API is available and that your environment variables are correctly loaded by the MCP runner.

Available tools

get-job-list

Retrieve a list of recommended job positions. Input: keyword (string, optional) and recruitType (number, optional: 1 Social Recruitment, 2 Campus Recruitment, 3 Internship). Returns an array of jobs with fields such as workPin, name, entityName, responsibility, requirement, welfare, salary, and detailUrl.

apply-for-job

Submit an application for a job position. Input: workPin (string). Returns the application result.

get-entity-list

Retrieve a list of managed entities. Returns an array of entities with entityPin, entityName, entityShortname, unifiedSocialCreditCode, entityLogo, and detailUrl.

get-entity-jobs

Retrieve job positions published under a specific entity. Input: entityPin. Returns an array of jobs with workPin, name, entityPin, responsibility, requirement, welfare, salary, and detailUrl.

get-recommend-talents

Retrieve recommended talents for a job position. Input: workPin. Returns an array of talents with userPin, birthday, university, major, highestEducation, workYears, workName, and matchDegree.

get-field-list

Retrieve a list of fields. Returns an array of fields with fid and name.

post-a-job

Post a new job position. Input: entityPin, fid, jobName, responsibility, requirement, city, and optional fields benefit and address. Returns the posting result.