{"_id":"@mindstone/mcp-server-humaans","_rev":"3-483d23ca050e69e5530337fa41acec84","name":"@mindstone/mcp-server-humaans","dist-tags":{"latest":"0.3.1"},"versions":{"0.2.2":{"name":"@mindstone/mcp-server-humaans","version":"0.2.2","license":"FSL-1.1-MIT","_id":"@mindstone/mcp-server-humaans@0.2.2","maintainers":[{"name":"mindstone-engineering","email":"engineering@mindstone.com"}],"homepage":"https://github.com/mindstone/mcp-servers/tree/main/connectors/humaans","bugs":{"url":"https://github.com/mindstone/mcp-servers/issues"},"bin":{"mcp-server-humaans":"dist/index.js"},"dist":{"shasum":"91dbde3b7694b264072c1594038bee39962d0c8c","tarball":"https://registry.npmjs.org/@mindstone/mcp-server-humaans/-/mcp-server-humaans-0.2.2.tgz","fileCount":29,"integrity":"sha512-GwyVg7vfsKY9eWiid7g6UqnGukvjf7cz8r93VZDXKKAo4toCT3cgkXNnEyuTIzqHXHn1fKNS4tzI7Oho0yN8Aw==","signatures":[{"sig":"MEUCIFA9R61i/UsloZL5xasMO+To7Rf0ocnJTpw36VW7Ety3AiEA8BTmAY24go4sZaI0RD8l+Z+aouokg6t0HsmNPPJiaL0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44321},"type":"module","engines":{"node":">=20"},"gitHead":"83878671b322434710c729d19cd790301bc68369","mcpName":"io.github.mindstone/mcp-server-humaans","scripts":{"test":"vitest run","build":"tsc && shx chmod +x dist/index.js","start":"node dist/index.js","watch":"tsc --watch","prepare":"npm run build","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"mindstone-engineering","email":"engineering@mindstone.com"},"overrides":{"hono":"^4.12.18","fast-uri":"^3.1.2","ip-address":"^10.2.0"},"repository":{"url":"git+https://github.com/mindstone/mcp-servers.git","type":"git","directory":"connectors/humaans"},"_npmVersion":"11.11.1","description":"Humaans HR platform MCP server for Model Context Protocol hosts","directories":{},"_nodeVersion":"25.8.2","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"msw":"^2.13.2","shx":"^0.3.4","vitest":"^4.1.3","typescript":"^5.8.2","@types/node":"^22","@vitest/coverage-v8":"^4.1.3","@mindstone/mcp-test-harness":"file:../../test-harness"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-humaans_0.2.2_1779136746466_0.39533542375855","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@mindstone/mcp-server-humaans","version":"0.3.0","license":"FSL-1.1-MIT","_id":"@mindstone/mcp-server-humaans@0.3.0","maintainers":[{"name":"mindstone-engineering","email":"engineering@mindstone.com"}],"homepage":"https://github.com/mindstone/mcp-servers/tree/main/connectors/humaans","bugs":{"url":"https://github.com/mindstone/mcp-servers/issues"},"bin":{"mcp-server-humaans":"dist/index.js"},"dist":{"shasum":"2e13b7c02b1cd3e60fbe78a1cdcd6059a93af630","tarball":"https://registry.npmjs.org/@mindstone/mcp-server-humaans/-/mcp-server-humaans-0.3.0.tgz","fileCount":35,"integrity":"sha512-6RlkyiK85LMcngDmEzz65LhnxSdgoC9O7xdVL/2UZxkGaeEwqhbKzB/pV8NRAKJS0YPy/8KEc+5lDzOfUGjaZg==","signatures":[{"sig":"MEUCIQDRCuJ8rkiJI6V7XVyDKSakNw/3UpBXq56g7UCc8ovIVwIgSFfZn+aGLAPYtJ8UzinSE0/EXRG9QpuueOrttYrWhtk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mindstone%2fmcp-server-humaans@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":75143},"type":"module","_from":"file:mindstone-mcp-server-humaans-0.3.0.tgz","engines":{"node":">=20"},"mcpName":"io.github.mindstone/mcp-server-humaans","scripts":{"test":"vitest run","build":"tsc && shx chmod +x dist/index.js","start":"node dist/index.js","watch":"tsc --watch","prepare":"npm run build","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d80655c2-08b7-4809-82c4-1b335d5aedbb"}},"_resolved":"/home/runner/work/mcp-servers/mcp-servers/mindstone-mcp-server-humaans-0.3.0.tgz","overrides":{"hono":"^4.12.18","fast-uri":"^3.1.2","ip-address":"^10.2.0"},"_integrity":"sha512-6RlkyiK85LMcngDmEzz65LhnxSdgoC9O7xdVL/2UZxkGaeEwqhbKzB/pV8NRAKJS0YPy/8KEc+5lDzOfUGjaZg==","repository":{"url":"git+https://github.com/mindstone/mcp-servers.git","type":"git","directory":"connectors/humaans"},"_npmVersion":"11.16.0","description":"Humaans HR platform MCP server for Model Context Protocol hosts","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"msw":"^2.13.2","shx":"^0.3.4","vitest":"^4.1.3","typescript":"^5.8.2","@types/node":"^22","@vitest/coverage-v8":"^4.1.3","@mindstone/mcp-test-harness":"file:../../test-harness"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-humaans_0.3.0_1786147052583_0.4789042298771111","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@mindstone/mcp-server-humaans","version":"0.3.1","mcpName":"io.github.mindstone/mcp-server-humaans","description":"Humaans HR platform MCP server for Model Context Protocol hosts","license":"FSL-1.1-MIT","type":"module","bin":{"mcp-server-humaans":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/mindstone/mcp-servers.git","directory":"connectors/humaans"},"homepage":"https://github.com/mindstone/mcp-servers/tree/main/connectors/humaans","publishConfig":{"access":"public"},"scripts":{"build":"tsc && shx chmod +x dist/index.js","prepare":"npm run build","watch":"tsc --watch","start":"node dist/index.js","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage"},"dependencies":{"@modelcontextprotocol/sdk":"^1.26.0","zod":"^3.23.0"},"devDependencies":{"@mindstone/mcp-test-harness":"file:../../test-harness","@types/node":"^22","@vitest/coverage-v8":"^4.1.3","msw":"^2.13.2","shx":"^0.3.4","typescript":"^5.8.2","vitest":"^4.1.3"},"engines":{"node":">=20"},"overrides":{"fast-uri":"^3.1.2","hono":"^4.12.18","ip-address":"^10.2.0"},"_id":"@mindstone/mcp-server-humaans@0.3.1","bugs":{"url":"https://github.com/mindstone/mcp-servers/issues"},"_integrity":"sha512-YqT5MHIM2C694+GAAdak0aRlCNc/pMdZeakBZIKXPtoeyILJVlXdu/QKwSDBxGj1POYZv1CZ+g8E+vdGb6VGeA==","_resolved":"/home/runner/work/mcp-servers/mcp-servers/mindstone-mcp-server-humaans-0.3.1.tgz","_from":"file:mindstone-mcp-server-humaans-0.3.1.tgz","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-YqT5MHIM2C694+GAAdak0aRlCNc/pMdZeakBZIKXPtoeyILJVlXdu/QKwSDBxGj1POYZv1CZ+g8E+vdGb6VGeA==","shasum":"81fdb293b56d1f3d90337d666045643e58b1b423","tarball":"https://registry.npmjs.org/@mindstone/mcp-server-humaans/-/mcp-server-humaans-0.3.1.tgz","fileCount":35,"unpackedSize":75993,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mindstone%2fmcp-server-humaans@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIADc5a1/tIY/fmvEaVw5DYn6M8anM0ZpmIibKj+ka+KFAiEAoYa0GZGohvBkRp3GPoQbBzdQhIE8jEduowY9N7HmZEY="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d80655c2-08b7-4809-82c4-1b335d5aedbb"}},"directories":{},"maintainers":[{"name":"mindstone-engineering","email":"engineering@mindstone.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-humaans_0.3.1_1786349369676_0.07189498475078326"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-18T20:39:06.354Z","modified":"2026-08-10T08:09:30.233Z","0.2.2":"2026-05-18T20:39:06.600Z","0.3.0":"2026-08-07T23:57:32.722Z","0.3.1":"2026-08-10T08:09:29.887Z"},"bugs":{"url":"https://github.com/mindstone/mcp-servers/issues"},"license":"FSL-1.1-MIT","homepage":"https://github.com/mindstone/mcp-servers/tree/main/connectors/humaans","repository":{"type":"git","url":"git+https://github.com/mindstone/mcp-servers.git","directory":"connectors/humaans"},"description":"Humaans HR platform MCP server for Model Context Protocol hosts","maintainers":[{"name":"mindstone-engineering","email":"engineering@mindstone.com"}],"readme":"# @mindstone/mcp-server-humaans\n\n[![npm version](https://img.shields.io/npm/v/@mindstone/mcp-server-humaans.svg)](https://www.npmjs.com/package/@mindstone/mcp-server-humaans)\n[![License: FSL-1.1-MIT](https://img.shields.io/badge/License-FSL--1.1--MIT-blue.svg)](./LICENSE)\n\nHumaans HR platform MCP server for Model Context Protocol hosts. Query employee profiles, job roles, time-away requests, company info, and office locations through a standardised MCP interface.\n\n## Status\n\n- **Version:** [0.3.1](./CHANGELOG.md) · [npm](https://www.npmjs.com/package/@mindstone/mcp-server-humaans)\n- **Auth:** API key ([`HUMAANS_API_KEY`](./server.json))\n- **Tools:** [16](./src/tools/) (people, job-roles, time-away, company, teams)\n- **Surface:** cloud-api\n- **Machine-readable:** [`STATUS.json`](./STATUS.json)\n\n## Requirements\n\n- Node.js 20+\n- npm\n\n<!-- BEGIN INSTALL_LINKS: do not edit by hand; regenerated by scripts/gen-install-links.mjs -->\n## One-click install\n\n[![Add to Cursor](https://img.shields.io/badge/Add_to_Cursor-black?style=for-the-badge&logo=cursor&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=Humaans&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaW5kc3RvbmUvbWNwLXNlcnZlci1odW1hYW5zIl0sImVudiI6eyJIVU1BQU5TX0FQSV9LRVkiOiIifX0)\n[![Add to VS Code](https://img.shields.io/badge/Add_to_VS_Code-007ACC?style=for-the-badge&logo=visual-studio-code&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22Humaans%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40mindstone%2Fmcp-server-humaans%22%5D%2C%22env%22%3A%7B%22HUMAANS_API_KEY%22%3A%22%22%7D%7D)\n[![Add to VS Code Insiders](https://img.shields.io/badge/Add_to_VS_Code_Insiders-24bfa5?style=for-the-badge&logo=visual-studio-code&logoColor=white)](vscode-insiders:mcp/install?%7B%22name%22%3A%22Humaans%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40mindstone%2Fmcp-server-humaans%22%5D%2C%22env%22%3A%7B%22HUMAANS_API_KEY%22%3A%22%22%7D%7D)\n\nAfter clicking the button, your host will prompt you to fill: `HUMAANS_API_KEY`.\n\n<details>\n<summary>Manual config for Claude Desktop / Claude Code / Goose / Continue.dev (Humaans)</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"Humaans\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@mindstone/mcp-server-humaans\"\n      ],\n      \"env\": {\n        \"HUMAANS_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\n</details>\n<!-- END INSTALL_LINKS -->\n\n## Quick Start\n\n### Install & build\n\n```bash\ncd <path-to-repo>/connectors/humaans\nnpm install\nnpm run build\n```\n\n### npx (once published)\n\n```bash\nnpx -y @mindstone/mcp-server-humaans\n```\n\n### Local\n\n```bash\nnode dist/index.js\n```\n\n## Configuration\n\n### Environment variables\n\n- `HUMAANS_API_KEY` — Humaans API access token (from app settings)\n- `MCP_HOST_BRIDGE_STATE` — optional path to a host bridge state file used for credential management\n- `MINDSTONE_REBEL_BRIDGE_STATE` — backwards-compatible alias for `MCP_HOST_BRIDGE_STATE`\n\n## Host configuration examples\n\n### Claude Desktop / Cursor\n\n```json\n{\n  \"mcpServers\": {\n    \"Humaans\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mindstone/mcp-server-humaans\"],\n      \"env\": {\n        \"HUMAANS_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Local development (no npm publish needed)\n\n```json\n{\n  \"mcpServers\": {\n    \"Humaans\": {\n      \"command\": \"node\",\n      \"args\": [\"<path-to-repo>/connectors/humaans/dist/index.js\"],\n      \"env\": {\n        \"HUMAANS_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Tools (16)\n\n### Configuration\n- `configure_humaans_api_key` — Configure the Humaans API access token\n\n### People\n- `get_humaans_me` — Get the current authenticated user's profile\n- `list_humaans_people` — List employees\n- `get_humaans_person` — Get full employee profile by ID\n- `list_humaans_teams` — List team names with member counts (derived from the people directory; Humaans has no dedicated teams endpoint)\n\n### Job roles\n- `list_humaans_job_roles` — List job role history for employees\n- `get_humaans_job_role` — Get a specific job role by ID\n\n### Time away\n- `list_humaans_time_away` — List time-away entries (PTO, sick leave, etc.)\n- `create_humaans_time_away` — Create a time-away request\n- `list_humaans_time_away_types` — List available time-away types\n- `list_humaans_time_away_allocations` — List time-away allocations (which policy applies to each person)\n- `cancel_humaans_time_away` — Cancel (permanently delete) a time-away entry\n- `approve_humaans_time_away` — Approve a pending time-away request (manager action)\n- `decline_humaans_time_away` — Decline a pending time-away request (manager action)\n\n### Company\n- `list_humaans_locations` — List company locations/offices\n- `get_humaans_company` — Get company information\n\n## Data handling\n\n- Person list responses are field-allowlisted; person detail responses strip sensitive fields (tax ID, personal email/phone, home address, birthday, profile photo).\n- Free-text fields authored in Humaans (time-away `note`/`reviewNote`, job-role `note`/`jobTitle`/`department`, time-away type and policy names, team names, person profile free text such as names/`bio`/social links/job title, location labels/cities, the company name) are returned inside `<untrusted-content>` envelopes so the model treats them as data, not instructions.\n- Humaans API error bodies are enveloped (and non-JSON bodies capped) before they reach the model; `Retry-After` reaches rate-limit messages only as a parsed integer, and a malformed 2xx body yields a static error rather than a parser message embedding a body snippet.\n\n## Licence\n\n[FSL-1.1-MIT](./LICENSE) — Functional Source License, Version 1.1, with MIT future licence. The software converts to MIT licence on 2030-04-08.\n","readmeFilename":"README.md"}