businys

Name: businys
Author: businys.app

Local

github.com/hiatysBusiness & Marketing0Updated 29w ago

Repository

About businys

Businys is an MCP server for independent professionals managing their business through the Businys platform. It exposes tools and resources spanning 26 practices, from client and invoice records to bookings and projects.

Key features

01221 tools across 26 practices
02Manage clients, invoices, and contracts
03Handle bookings, projects, and programs
04Access business context and client resources
05Discover account tools with get_manifest

Use cases

01Review client and invoice information with an agent
02Manage bookings and projects through an MCP client
03Retrieve a snapshot of current business context

MCP support

The server exposes Businys account tools and resources to MCP-compatible clients over stdio, or via the platform's streamable HTTP endpoint. It requires a HIATYS_API_KEY.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "app-businys": {
      "command": "npx",
      "args": [
        "-y",
        "@businys/mcp-server"
      ]
    }
  }
}

Run commandnpx -y @businys/mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@businys/mcp-server1.0.1stdio

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.