{"_id":"@calybur/mcp","_rev":"4-ca2a9e0031b0a0978dea0e13327cd2c8","name":"@calybur/mcp","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.0":{"name":"@calybur/mcp","version":"0.1.0","keywords":["mcp","calybur","payroll","hrms","malaysia","model-context-protocol"],"author":{"name":"Calybur"},"license":"MIT","_id":"@calybur/mcp@0.1.0","maintainers":[{"name":"creaitech","email":"creaitechnology@gmail.com"}],"homepage":"https://www.calybur.com","bugs":{"url":"https://github.com/CreaiTechnology/ezgaji-payroll/issues"},"bin":{"calybur-mcp":"dist/index.js"},"dist":{"shasum":"3270955a5d63b86fc52f0176e7d9f2f69d888882","tarball":"https://registry.npmjs.org/@calybur/mcp/-/mcp-0.1.0.tgz","fileCount":34,"integrity":"sha512-g2BCC5vVsjMCBIU3Y5WQZ3tfYaLY4jU6vJ0RbS66GY7q/VTIA5HYi8Q6fP8zsM2PV4bUY3ATVsBnusn9oM/q2w==","signatures":[{"sig":"MEUCIERJ/326chXXRDvdqqtF/92NFk11GjKOpZLpKjRjaEBKAiEA1KIDFqMlk8GnsZGVwMSm+kJCxvnsRZV+N2VChRDV6EQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31032},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"gitHead":"969c4f1ad0992aae77e4090aa317f73bc1020898","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","pack:dry":"npm run build && npm pack --dry-run","test:watch":"vitest","prepublishOnly":"npm run test && npm run build"},"_npmUser":{"name":"creaitech","email":"creaitechnology@gmail.com"},"repository":{"url":"git+https://github.com/CreaiTechnology/ezgaji-payroll.git","type":"git","directory":"packages/calybur-mcp"},"_npmVersion":"11.11.0","description":"MCP server for Calybur payroll and HR Partner API","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1781492895005_0.07296597035127017","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@calybur/mcp","version":"0.2.0","keywords":["mcp","calybur","payroll","hrms","malaysia","model-context-protocol"],"author":{"name":"Calybur"},"license":"MIT","_id":"@calybur/mcp@0.2.0","maintainers":[{"name":"creaitech","email":"creaitechnology@gmail.com"}],"homepage":"https://www.calybur.com","bugs":{"url":"https://github.com/CreaiTechnology/ezgaji-payroll/issues"},"bin":{"calybur-mcp":"dist/index.js"},"dist":{"shasum":"1e9872848bea0fa73ee73f34e026f409b8dc24cb","tarball":"https://registry.npmjs.org/@calybur/mcp/-/mcp-0.2.0.tgz","fileCount":34,"integrity":"sha512-OC5Ka4l3VIPVw6Cx/OBg5vBbM4/+hhamL7uciXQXCfJvRCcT4ebAI/rxCzf2jxbIO8W4e18cZOay87p185MYPg==","signatures":[{"sig":"MEUCIBwdhxsTC36gF0pLQxBEJcKsx+nbiO/ZtNBbJGrJuXNOAiEA0y+4tEKELOr/hL8fQs4hhr3/KyJMuXHcXRU3lu364xA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31404},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"gitHead":"969c4f1ad0992aae77e4090aa317f73bc1020898","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","pack:dry":"npm run build && npm pack --dry-run","test:watch":"vitest","prepublishOnly":"npm run test && npm run build"},"_npmUser":{"name":"creaitech","email":"creaitechnology@gmail.com"},"repository":{"url":"git+https://github.com/CreaiTechnology/ezgaji-payroll.git","type":"git","directory":"packages/calybur-mcp"},"_npmVersion":"11.11.0","description":"MCP server for Calybur payroll and HR Partner API","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1781497493804_0.18695912487076627","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@calybur/mcp","version":"0.2.2","keywords":["mcp","calybur","payroll","hrms","malaysia","model-context-protocol"],"author":{"name":"Calybur"},"license":"MIT","_id":"@calybur/mcp@0.2.2","maintainers":[{"name":"creaitech","email":"creaitechnology@gmail.com"}],"homepage":"https://www.calybur.com","bugs":{"url":"https://github.com/CreaiTechnology/ezgaji-payroll/issues"},"bin":{"calybur-mcp":"dist/index.js"},"dist":{"shasum":"b69132c11c76ff16ef9e6d6db9f99116e63e5486","tarball":"https://registry.npmjs.org/@calybur/mcp/-/mcp-0.2.2.tgz","fileCount":36,"integrity":"sha512-oBEKUsqG/tjcKznDsD2iHYOfu3UWBX8L0WkzwXL2bW/P/8JzisOvElyXkPxc9BS5lFyISpQB1wDvl3EAxn2yOA==","signatures":[{"sig":"MEQCICeWVfGoZWkNR7BeMKOIpA7QIgUOkGKXrLkcFWtJ8vQ9AiAoOJ2u4Jdmzl5vuhO3tTwjmxWujzDA0UQOmk/w7KPUYQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39070},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"gitHead":"1a9b2b49a27128530173be6520281c99f1966edf","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","pack:dry":"npm run build && npm pack --dry-run","test:watch":"vitest","prepublishOnly":"npm run test && npm run build"},"_npmUser":{"name":"creaitech","email":"creaitechnology@gmail.com"},"repository":{"url":"git+https://github.com/CreaiTechnology/ezgaji-payroll.git","type":"git","directory":"packages/calybur-mcp"},"_npmVersion":"11.11.0","description":"MCP server for Calybur payroll and HR Partner API","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.2_1781604039934_0.5956795107551884","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@calybur/mcp","version":"0.2.3","description":"MCP server for Calybur payroll and HR Partner API","type":"module","license":"MIT","author":{"name":"Calybur"},"homepage":"https://www.calybur.com","repository":{"type":"git","url":"git+https://github.com/CreaiTechnology/ezgaji-payroll.git","directory":"packages/calybur-mcp"},"bugs":{"url":"https://github.com/CreaiTechnology/ezgaji-payroll/issues"},"keywords":["mcp","calybur","payroll","hrms","malaysia","model-context-protocol"],"publishConfig":{"access":"public"},"bin":{"calybur-mcp":"dist/index.js"},"main":"./dist/index.js","scripts":{"build":"tsc -p tsconfig.json","dev":"tsx src/index.ts","test":"vitest run","test:watch":"vitest","prepublishOnly":"npm run test && npm run build","pack:dry":"npm run build && npm pack --dry-run"},"engines":{"node":">=20"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.10.0","tsx":"^4.19.0","typescript":"^5.7.0","vitest":"^3.0.0"},"_id":"@calybur/mcp@0.2.3","gitHead":"f997141883534390542b661168d4f23b461379af","types":"./dist/index.d.ts","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-FvTEhETDqJR0qUSfA48JhYV8Q9L7decQmDQ7DSiHW7nwUNVHSYzxa0uOo5wSQbeOHWuv73o9i6bZm5o8xMzk7A==","shasum":"bae3d98d6225c720ce0d75515e2b7a2e7d79d8ee","tarball":"https://registry.npmjs.org/@calybur/mcp/-/mcp-0.2.3.tgz","fileCount":36,"unpackedSize":38894,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAMqat2Br6M937dtm8q9zfR1vAVICMBeCjjpdHKgLzSfAiAPoL7OSao6etEXMSKyCeqtHtmCj7OTQxEW1pXddvPn1Q=="}]},"_npmUser":{"name":"creaitech","email":"creaitechnology@gmail.com"},"directories":{},"maintainers":[{"name":"creaitech","email":"creaitechnology@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.2.3_1781612751578_0.8605396104278915"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-15T03:08:14.913Z","modified":"2026-06-16T12:25:51.871Z","0.1.0":"2026-06-15T03:08:15.150Z","0.2.0":"2026-06-15T04:24:53.942Z","0.2.2":"2026-06-16T10:00:40.067Z","0.2.3":"2026-06-16T12:25:51.718Z"},"bugs":{"url":"https://github.com/CreaiTechnology/ezgaji-payroll/issues"},"author":{"name":"Calybur"},"license":"MIT","homepage":"https://www.calybur.com","keywords":["mcp","calybur","payroll","hrms","malaysia","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/CreaiTechnology/ezgaji-payroll.git","directory":"packages/calybur-mcp"},"description":"MCP server for Calybur payroll and HR Partner API","maintainers":[{"name":"creaitech","email":"creaitechnology@gmail.com"}],"readme":"# @calybur/mcp\n\nOfficial MCP server for [Calybur](https://www.calybur.com) — connect **external MCP-compatible agents** to your Malaysian payroll and HR data via the Partner API.\n\nMost Calybur customers use **AI Workspace** inside the product for day-to-day questions. This package is for integrators who want Claude Desktop, custom agents, automation runners, or any MCP client to query Calybur with an API key.\n\n## Requirements\n\n- Node.js 20+\n- Calybur **Starter** plan or above\n- API key with `read` scope — create at **Settings → API Keys** in Calybur\n- Optional MCP setup copy at **Settings → Integrations**\n\n## Setup in Calybur\n\n1. Create a Partner API key (`ezg_live_*`) with read scope.\n2. Open **Settings → Integrations** and copy the MCP config snippet, or use the example below.\n3. Paste the config into your MCP client (stdio transport).\n\n## Connect any MCP client\n\n```json\n{\n  \"mcpServers\": {\n    \"calybur\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@calybur/mcp@latest\"],\n      \"env\": {\n        \"CALYBUR_API_KEY\": \"ezg_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart your MCP client and enable the Calybur tools. Cursor, Claude Desktop, and other stdio MCP hosts use the same shape; only the config file location differs.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `CALYBUR_API_KEY` | Yes | Partner API key (`ezg_live_*`) |\n| `CALYBUR_PLAN` | No | `starter` (default), `professional`, or `enterprise` |\n| `CALYBUR_API_BASE_URL` | No | Defaults to `https://api.calybur.com` |\n| `CALYBUR_SUPABASE_PUBLISHABLE_KEY` | No | Only if bypassing the gateway with a direct Supabase URL |\n\n## Tools (MVP — read-only)\n\n| Tool | Purpose |\n|------|---------|\n| `calybur_workforce` | Query employees, departments, positions, and work locations from Calybur. |\n| `calybur_leave` | Query leave balances, requests, policies, and public holidays. |\n| `calybur_payroll` | Query payroll periods, run status, and payslips. |\n| `calybur_attendance` | Query attendance events and summaries. |\n| `calybur_commission` | Query commission rules and calculation results. |\n| `calybur_reports` | Fetch payroll summary or statutory export metadata for a period. |\n| `calybur_status` | Check API key validity and remaining MCP client rate budget. |\n| `calybur_docs` | Search bundled Calybur API and Malaysia statutory documentation. |\n\n### Actions by tool\n\n- **calybur_workforce**: list_employees, get_employee, list_departments, list_positions, list_work_locations\n- **calybur_leave**: list_balances, list_requests, list_policies, list_holidays\n- **calybur_payroll**: list_periods, get_run, list_payslips\n- **calybur_attendance**: list_events, list_summaries\n- **calybur_commission**: list_rules, list_calculations\n- **calybur_reports**: payroll_summary, statutory_metadata\n\n`calybur_status` and `calybur_docs` have dedicated input shapes (no `action` enum).\n\n## Example prompts\n\n- \"Use calybur_status to verify my API connection\"\n- \"List active employees with calybur_workforce\"\n- \"Show March payroll periods with calybur_payroll\"\n\n## Development\n\n```bash\ncd packages/calybur-mcp\nnpm install\nnpm test\nnpm run build\nCALYBUR_API_KEY=ezg_live_... npm run dev\n```\n\n## Rate limits\n\n| Plan | API limit | MCP client budget (90%) |\n|------|-----------|-------------------------|\n| Starter | 100/min | 90/min |\n| Professional | 500/min | 450/min |\n| Enterprise | 2000/min | 1800/min |\n\n## License\n\nMIT\n\n## Publishing\n\nSee [PUBLISHING.md](./PUBLISHING.md). Published package: `@calybur/mcp` on npm.\n","readmeFilename":"README.md"}