CultureMonkey MCP by usefulapi
List, add, update and deactivate employees in CultureMonkey.
Should I use this
Quality & Safety
Findings (1)
- LOWin culturemonkey_deactivate_employee
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"culturemonkey": {
"url": "https://culturemonkey.usefulapi.io/mcp"
}
}
}Remote endpoints
https://culturemonkey.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢culturemonkey_list_employees(page)
List one page (100 employees) of the account's employee directory: names, emails, external_id, team, location, manager, dates and active status. The reply has meta.total_page; call again with page+1 until it passes that number. Read-only. GET /api/v1/employees.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number, 100 employees per page (default 1). Stop when the page passes meta.total_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢culturemonkey_get_employee(external_id)
Fetch one employee by external_id, the stable id your system assigned. Read-only. GET /api/v1/employees/{external_id}.
Input Schema
{
"type": "object",
"properties": {
"external_id": {
"type": "string",
"minLength": 1,
"description": "The employee's external_id: the stable id from your own system (HRIS profile id, for example)."
}
},
"required": [
"external_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴culturemonkey_create_employee(first_name, email_address, external_id, team_name, location_name, ...)
Add an employee to the directory. Required: first_name, email_address, external_id, team_name, location_name. A team, location, sub-team, business unit or group that does not exist is created. A manager must already exist. Fails with 409 if external_id is taken (use update). POST /api/v1/employees.
Input Schema
{
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"description": "First name."
},
"email_address": {
"type": "string",
"minLength": 3,
"description": "Official email address."
},
"external_id": {
"type": "string",
"minLength": 1,
"description": "The employee's external_id: the stable id from your own system (HRIS profile id, for example)."
},
"team_name": {
"type": "string",
"minLength": 1,
"description": "Team (created if new)."
},
"location_name": {
"type": "string",
"minLength": 1,
"description": "Location (created if new)."
},
"last_name": {
"description": "Last name.",
"type": "string",
"minLength": 1
},
"employee_id": {
"description": "Optional HR identifier (not the lookup key; external_id is).",
"type": "string",
"minLength": 1
},
"designation": {
"description": "Job title.",
"type": "string",
"minLength": 1
},
"manager_email": {
"description": "Manager's email. The manager must already exist in CultureMonkey.",
"type": "string",
"minLength": 1
},
"manager_employee_id": {
"description": "Manager's employee_id. The manager must already exist in CultureMonkey.",
"type": "string",
"minLength": 1
},
"subteam_name": {
"description": "Sub-team name (created if new).",
"type": "string",
"minLength": 1
},
"business_unit_name": {
"description": "Business unit name (created if new).",
"type": "string",
"minLength": 1
},
"business_group_name": {
"description": "Business group name (created if new).",
"type": "string",
"minLength": 1
},
"date_of_joining": {
"description": "Start date, YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_of_birth": {
"description": "Date of birth, YYYY-MM-DD. Personal data: send only when needed.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_of_separation": {
"description": "Leaving date, YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"gender": {
"description": "Gender, as your CultureMonkey account expects it. Personal data.",
"type": "string",
"minLength": 1
},
"phone_number": {
"description": "Phone number. Personal data.",
"type": "string",
"minLength": 1
},
"employee_type": {
"description": "Employment type, as your CultureMonkey account defines it.",
"type": "string",
"minLength": 1
},
"role_type": {
"description": "Role type, as your CultureMonkey account defines it.",
"type": "string",
"minLength": 1
},
"question_language": {
"description": "Language code for survey questions.",
"type": "string",
"minLength": 1
},
"custom_attributes": {
"description": "Free-form custom attributes (key/value object).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"first_name",
"email_address",
"external_id",
"team_name",
"location_name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴culturemonkey_update_employee(external_id, first_name, email_address, team_name, location_name, ...)
Change fields of one employee, identified by external_id. Send only the fields to change; the others stay as they are. external_id itself cannot change. PUT /api/v1/employees/{external_id}.
Input Schema
{
"type": "object",
"properties": {
"external_id": {
"type": "string",
"minLength": 1,
"description": "The employee's external_id: the stable id from your own system (HRIS profile id, for example)."
},
"first_name": {
"description": "First name.",
"type": "string",
"minLength": 1
},
"email_address": {
"description": "Official email address.",
"type": "string",
"minLength": 3
},
"team_name": {
"description": "Team (created if new).",
"type": "string",
"minLength": 1
},
"location_name": {
"description": "Location (created if new).",
"type": "string",
"minLength": 1
},
"last_name": {
"description": "Last name.",
"type": "string",
"minLength": 1
},
"employee_id": {
"description": "Optional HR identifier (not the lookup key; external_id is).",
"type": "string",
"minLength": 1
},
"designation": {
"description": "Job title.",
"type": "string",
"minLength": 1
},
"manager_email": {
"description": "Manager's email. The manager must already exist in CultureMonkey.",
"type": "string",
"minLength": 1
},
"manager_employee_id": {
"description": "Manager's employee_id. The manager must already exist in CultureMonkey.",
"type": "string",
"minLength": 1
},
"subteam_name": {
"description": "Sub-team name (created if new).",
"type": "string",
"minLength": 1
},
"business_unit_name": {
"description": "Business unit name (created if new).",
"type": "string",
"minLength": 1
},
"business_group_name": {
"description": "Business group name (created if new).",
"type": "string",
"minLength": 1
},
"date_of_joining": {
"description": "Start date, YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_of_birth": {
"description": "Date of birth, YYYY-MM-DD. Personal data: send only when needed.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_of_separation": {
"description": "Leaving date, YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"gender": {
"description": "Gender, as your CultureMonkey account expects it. Personal data.",
"type": "string",
"minLength": 1
},
"phone_number": {
"description": "Phone number. Personal data.",
"type": "string",
"minLength": 1
},
"employee_type": {
"description": "Employment type, as your CultureMonkey account defines it.",
"type": "string",
"minLength": 1
},
"role_type": {
"description": "Role type, as your CultureMonkey account defines it.",
"type": "string",
"minLength": 1
},
"question_language": {
"description": "Language code for survey questions.",
"type": "string",
"minLength": 1
},
"custom_attributes": {
"description": "Free-form custom attributes (key/value object).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"external_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴culturemonkey_deactivate_employee(external_id)
Offboard one employee by external_id. This is a soft delete: it sets is_active to false, stops future survey sends and keeps the historical responses. No tool in this server erases data. DELETE /api/v1/employees/{external_id}.
Input Schema
{
"type": "object",
"properties": {
"external_id": {
"type": "string",
"minLength": 1,
"description": "The employee's external_id: the stable id from your own system (HRIS profile id, for example)."
}
},
"required": [
"external_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence