{"_id":"@businys/mcp-server","_rev":"2-a7ac4dff36695b1c5a816c3769170f53","name":"@businys/mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@businys/mcp-server","version":"1.0.0","keywords":["mcp","modelcontextprotocol","businys","freelance","independent-professional","practice-management","ai-agent"],"license":"MIT","_id":"@businys/mcp-server@1.0.0","maintainers":[{"name":"hiatys","email":"chris@hiatys.com"}],"homepage":"https://github.com/hiatys/businys-mcp#readme","bugs":{"url":"https://github.com/hiatys/businys-mcp/issues"},"bin":{"businys-mcp":"dist/index.js"},"dist":{"shasum":"58ace3f67216691dbfbce7dae8688b246ea88814","tarball":"https://registry.npmjs.org/@businys/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":4,"integrity":"sha512-nsTWNL2sid9VdBGFRs009Bs8T3V7vBSvpqsWE98n0ZM3/1zeY76YNV+8im38A8ZxV9MurXn8LXPPLsvrtbQSEw==","signatures":[{"sig":"MEUCIQDwoRCvBWeESjoIcN05YwCDmNy9Hj7EaaWmUp3WO3LVMQIgbsgwy3j5waHsCX1iOLBmpC+3JNMYYXUsAsrdA24hd6g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":194277},"main":"dist/index.js","engines":{"node":">=18"},"gitHead":"c3ead4b3712bb76d57378e40d6c4094bb870101d","scripts":{"build":"tsup","type-check":"tsc --noEmit","prepublishOnly":"tsup"},"_npmUser":{"name":"hiatys","email":"chris@hiatys.com"},"repository":{"url":"git+https://github.com/hiatys/businys-mcp.git","type":"git"},"_npmVersion":"10.1.0","description":"Official MCP server for Businys — 221 tools across 26 practices for independent professionals","directories":{},"_nodeVersion":"20.9.0","dependencies":{"@hiatys/mcp":"workspace:*","@hiatys/kits":"workspace:*","@hiatys/mcp-tools":"workspace:*","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8","typescript":"^5","@types/node":"^20","@hiatys/config":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1775078352425_0.8783510217131345","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@businys/mcp-server","version":"1.0.1","mcpName":"app.businys/mcp-server","description":"Official MCP server for Businys — 221 tools across 26 practices for independent professionals","main":"dist/index.js","bin":{"businys-mcp":"dist/index.js"},"scripts":{"build":"tsup","prepublishOnly":"tsup","type-check":"tsc --noEmit"},"dependencies":{"@businys/ops":"workspace:*","@hiatys/kits":"workspace:*","@hiatys/mcp":"workspace:*","@hiatys/mcp-tools":"workspace:*","@modelcontextprotocol/sdk":"^1.12.1"},"devDependencies":{"@hiatys/config":"workspace:*","@types/node":"^20","tsup":"^8","typescript":"^5"},"engines":{"node":">=18"},"keywords":["mcp","modelcontextprotocol","businys","freelance","independent-professional","practice-management","ai-agent"],"repository":{"type":"git","url":"git+https://github.com/hiatys/businys-mcp.git"},"homepage":"https://github.com/hiatys/businys-mcp#readme","bugs":{"url":"https://github.com/hiatys/businys-mcp/issues"},"license":"MIT","publishConfig":{"access":"public"},"_id":"@businys/mcp-server@1.0.1","gitHead":"bbb8dfc849e308d1e9071f53467ec5ffaf2c81f7","_nodeVersion":"20.9.0","_npmVersion":"10.1.0","dist":{"integrity":"sha512-8nfTXBaOVk6/5mcc/1KabYt/CRkT1J+j/lmn3fpY/uG97ex+C1WoVBH4advD15rwfu6nZvZMJd+KXqjZGhvoJw==","shasum":"87c97d5eb6b111fc9c195992d50566b989f4ca0c","tarball":"https://registry.npmjs.org/@businys/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":4,"unpackedSize":187448,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAYUReCDru/g4xJnOeq1RPvN4ykC+1ZHv5PlJBkxnpanAiAP6hrON26y/ainr9Ecgc/ncrvimG1ugnKyFQ0wpMkNFA=="}]},"_npmUser":{"name":"hiatys","email":"chris@hiatys.com"},"directories":{},"maintainers":[{"name":"hiatys","email":"chris@hiatys.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.1_1775148064118_0.5972250296562931"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T21:19:12.362Z","modified":"2026-04-02T16:41:04.417Z","1.0.0":"2026-04-01T21:19:12.549Z","1.0.1":"2026-04-02T16:41:04.272Z"},"bugs":{"url":"https://github.com/hiatys/businys-mcp/issues"},"license":"MIT","homepage":"https://github.com/hiatys/businys-mcp#readme","keywords":["mcp","modelcontextprotocol","businys","freelance","independent-professional","practice-management","ai-agent"],"repository":{"type":"git","url":"git+https://github.com/hiatys/businys-mcp.git"},"description":"Official MCP server for Businys — 221 tools across 26 practices for independent professionals","maintainers":[{"name":"hiatys","email":"chris@hiatys.com"}],"readme":"# @businys/mcp-server\n\nOfficial MCP server for [Businys](https://businys.app) — the unified platform for independent professionals.\n\n**221 tools across 26 practices.** Clients, invoices, contracts, bookings, programs, projects, and more — all accessible to any MCP-compatible AI agent.\n\n## Installation\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"businys\": {\n      \"command\": \"npx\",\n      \"args\": [\"@businys/mcp-server\"],\n      \"env\": {\n        \"HIATYS_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Other MCP clients\n\n```bash\nnpx @businys/mcp-server\n```\n\nRequires `HIATYS_API_KEY` environment variable.\n\n## Getting an API Key\n\n1. Sign in at [businys.app](https://businys.app)\n2. Go to **Settings → API Keys**\n3. Create a new key with the scopes you need\n4. Paste it into your MCP client config\n\nAPI access requires a paid plan (Starter $12/mo and above).\n\n## What's Included\n\n### Tools (221 total)\n\nThe server exposes tools for everything your Businys account has active:\n\n| Practice | Tools |\n|---|---|\n| Photography | Clients, quotes, galleries, contracts, invoices, gear, licensing |\n| Fitness | Clients, programs, workouts, progress tracking, sessions |\n| Design | Projects, proposals, contracts, invoices, deliverables |\n| Brand | Brand guidelines, identity systems, deliverables |\n| Videography | Projects, shot lists, contracts, deliverables |\n| Yoga | Classes, memberships, bookings, packages |\n| Life Coaching | Sessions, programs, check-ins, goals |\n| Consulting | Engagements, deliverables, timesheets |\n| Tutoring | Students, sessions, progress, packages |\n| Music Lessons | Students, lesson plans, sessions, packages |\n| Online Courses | Courses, modules, enrollments, progress |\n| Wedding Planning | Weddings, vendors, timelines, budgets |\n| Social Media | Clients, campaigns, content calendars |\n| Hair Salon | Clients, appointments, services, packages |\n| Nail Tech | Clients, appointments, services, packages |\n| Massage Therapy | Clients, intake forms, packages, SOAP notes |\n| Tattoo | Clients, bookings, deposits, aftercare |\n| Cleaning | Properties, checklists, schedules, invoicing |\n| Landscaping | Properties, services, schedules, invoicing |\n| Pet Grooming | Pets, clients, appointments, services |\n| Newsletter | Subscribers, issues, sponsorships, analytics |\n| YouTube Creator | Videos, sponsors, analytics, revenue |\n| Podcasting | Episodes, guests, sponsors, analytics |\n| Copywriting | Clients, projects, briefs, deliverables |\n| Freelance Dev | Clients, projects, timesheets, invoices |\n| AI Consulting | Clients, engagements, prompt libraries |\n\nPlus cross-practice tools: clients, invoices, contracts, bookings, assets, automations, bulk operations, and more.\n\n### Resources\n\n- `hiatys://context/current` — Live business context snapshot\n- `hiatys://data/clients` — Active client list\n- `hiatys://clients/{id}` — Individual client details\n- `hiatys://context/{sections}` — Selective context by section\n- `hiatys://profiles/{slug}` — Public profile page data\n\n### Tool Discovery\n\nUse the built-in `get_manifest` tool to see all available tools, groups, and resources for your account.\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `HIATYS_API_KEY` | Yes | — | Your Businys API key |\n| `HIATYS_BASE_URL` | No | `https://businys.app` | Override for self-hosted or staging |\n\n## Transport\n\nThis package runs as a **stdio transport** — suitable for Claude Desktop, Cursor, Cline, and other local MCP clients.\n\nFor HTTP/streamable-http transport, connect directly to `https://businys.app/api/mcp` using your API key as a Bearer token.\n\n## Data & Privacy\n\n- All data lives in your Businys account\n- The server proxies API calls — no data is stored by the MCP server process\n- Canadian data residency (`ca-central-1`) — PIPEDA compliant\n- Full data export available at any time from Settings\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n## Links\n\n- [Businys](https://businys.app)\n- [Documentation](https://businys.app/docs)\n- [Issues](https://github.com/hiatys/businys-mcp/issues)\n- [MCP Server Card](https://businys.app/.well-known/mcp-server-card.json)\n","readmeFilename":"README.md"}