{
  "markdown": "# @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",
  "bytes": 4225,
  "sha": "0f366cf74f7bfba9bdfa8de21c8b60c130402919ce36592bc413cc1df629d990",
  "repo_slug": "hiatys/businys-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_app_businys_mcp_server_bda41536/readme"
}