app.businys/mcp-server
221 MCP tools across 26 practices for independent professionals. Clients, invoices, contracts.
Open source Open in the app JSON README (API)
About
221 MCP tools across 26 practices for independent professionals. Clients, invoices, contracts.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- app.businys
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Last push
- 2026-04-07T16:00:39Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:00:44
- Updated
- 2026-08-29 03:00:44
- Origin id
app.businys/mcp-server
README
# @businys/mcp-server
Official MCP server for [Businys](https://businys.app) — the unified platform for independent professionals.
**221 tools across 26 practices.** Clients, invoices, contracts, bookings, programs, projects, and more — all accessible to any MCP-compatible AI agent.
## Installation
### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"businys": {
"command": "npx",
"args": ["@businys/mcp-server"],
"env": {
"HIATYS_API_KEY": "your-api-key-here"
}
}
}
}
```
### Other MCP clients
```bash
npx @businys/mcp-server
```
Requires `HIATYS_API_KEY` environment variable.
## Getting an API Key
1. Sign in at [businys.app](https://businys.app)
2. Go to **Settings → API Keys**
3. Create a new key with the scopes you need
4. Paste it into your MCP client config
API access requires a paid plan (Starter $12/mo and above).
## What's Included
### Tools (221 total)
The server exposes tools for everything your Businys account has active:
| Practice | Tools |
|---|---|
| Photography | Clients, quotes, galleries, contracts, invoices, gear, licensing |
| Fitness | Clients, programs, workouts, progress tracking, sessions |
| Design | Projects, proposals, contracts, invoices, deliverables |
| Brand | Brand guidelines, identity systems, deliverables |
| Videography | Projects, shot lists, contracts, deliverables |
| Yoga | Classes, memberships, bookings, packages |
| Life Coaching | Sessions, programs, check-ins, goals |
| Consulting | Engagements, deliverables, timesheets |
| Tutoring | Students, sessions, progress, packages |
| Music Lessons | Students, lesson plans, sessions, packages |
| Online Courses | Courses, modules, enrollments, progress |
| Wedding Planning | Weddings, vendors, timelines, budgets |
| Social Media | Clients, campaigns, content calendars |
| Hair Salon | Clients, appointments, services, packages |
| Nail Tech | Clients, appointments, services, packages |
| Massage Therapy | Clients, intake forms, packages, SOAP notes |
| Tattoo | Clients, bookings, deposits, aftercare |
| Cleaning | Properties, checklists, schedules, invoicing |
| Landscaping | Properties, services, schedules, invoicing |
| Pet Grooming | Pets, clients, appointments, services |
| Newsletter | Subscribers, issues, sponsorships, analytics |
| YouTube Creator | Videos, sponsors, analytics, revenue |
| Podcasting | Episodes, guests, sponsors, analytics |
| Copywriting | Clients, projects, briefs, deliverables |
| Freelance Dev | Clients, projects, timesheets, invoices |
| AI Consulting | Clients, engagements, prompt libraries |
Plus cross-practice tools: clients, invoices, contracts, bookings, assets, automations, bulk operations, and more.
### Resources
- `hiatys://context/current` — Live business context snapshot
- `hiatys://data/clients` — Active client list
- `hiatys://clients/{id}` — Individual client details
- `hiatys://context/{sections}` — Selective context by section
- `hiatys://profiles/{slug}` — Public profile page data
### Tool Discovery
Use the built-in `get_manifest` tool to see all available tools, groups, and resources for your account.
## Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
| `HIATYS_API_KEY` | Yes | — | Your Businys API key |
| `HIATYS_BASE_URL` | No | `https://businys.app` | Override for self-hosted or staging |
## Transport
This package runs as a **stdio transport** — suitable for Claude Desktop, Cursor, Cline, and other local MCP clients.
For HTTP/streamable-http transport, connect directly to `https://businys.app/api/mcp` using your API key as a Bearer token.
## Data & Privacy
- All data lives in your Businys account
- The server proxies API calls — no data is stored by the MCP server process
- Canadian data residency (`ca-central-1`) — PIPEDA compliant
- Full data export available at any time from Settings
## License
MIT — see [LICENSE](LICENSE)
## Links
- [Businys](https://businys.app)
- [Documentation](https://businys.app/docs)
- [Issues](https://github.com/hiatys/businys-mcp/issues)
- [MCP Server Card](https://businys.app/.well-known/mcp-server-card.json)