app.businys/mcp-server

Official

by hiatys · TypeScript

221 MCP tools across 26 practices for independent professionals. Clients, invoices, contracts.

app.businys/mcp-server (MCP)

The app.businys/mcp-server is the official MCP server for Businys, a unified platform for independent professionals. It exposes MCP-compatible tools focused on managing professional operations such as clients, invoices, contracts, bookings, and projects. Tool access is intended for any MCP-compatible AI agent.

🛠️ Key Features

221 MCP tools
26 practices
Coverage includes clients, invoices, contracts, and bookings
Also includes programs and projects

🚀 Use Cases

Let AI agents work with client data
Support invoice and contract workflows
Handle bookings
Manage programs and projects through MCP tools

⚡ Developer Benefits

One MCP server providing access to 221 tools across 26 practices
Works with any MCP-compatible AI agent
Configured via an MCP server entry (e.g., Claude Desktop)

⚠️ Limitations

Installation details are described for Claude Desktop only (partial installation instructions provided)

README.md4 KBView on 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:

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

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 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

Install

Add to VS Code Add to Cursor

claude_desktop_config.json