app.businys/mcp-server
221 MCP tools across 26 practices for independent professionals. Clients, invoices, contracts.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@businys/mcp-serverclaude mcp add app-businys-mcp-server -- npx -y @businys/mcp-server@1.0.1
{
"mcpServers": {
"app-businys-mcp-server": {
"command": "npx",
"args": [
"-y",
"@businys/mcp-server@1.0.1"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
@businys/mcp-server
Official MCP server for Businys — 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:
{
"mcpServers": {
"businys": {
"command": "npx",
"args": ["@businys/mcp-server"],
"env": {
"HIATYS_API_KEY": "your-api-key-here"
}
}
}
}
Other MCP clients
npx @businys/mcp-server
Requires HIATYS_API_KEY environment variable.
Getting an API Key
- Sign in at businys.app
- Go to Settings → API Keys
- Create a new key with the scopes you need
- 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 snapshothiatys://data/clients— Active client listhiatys://clients/{id}— Individual client detailshiatys://context/{sections}— Selective context by sectionhiatys://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
Links
الأسئلة الشائعة
ما هو app.businys/mcp-server؟
221 MCP tools across 26 practices for independent professionals. Clients, invoices, contracts.
كيف أثبّت app.businys/mcp-server؟
يعمل على جهازك. في Claude Code: claude mcp add app-businys-mcp-server -- npx -y @businys/mcp-server@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج app.businys/mcp-server إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل app.businys/mcp-server مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون app.businys/mcp-server؟
ينشره hiatys. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.