How do I install Businys?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Businys need an API key?

No required environment variable is listed on this record.

What transport does Businys use?

Businys runs locally over stdio.

When was Businys last checked?

Last checked 2026-11-07. 221 MCP tools across 26 practices for independent professionals. Clients, invoices, contracts.

Businys MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @businys/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add app.businys-mcp-server -- npx -y @businys/mcp-server@1.0.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "app.businys-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@businys/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

@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

Businys

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Businys?

Does Businys need an API key?

What transport does Businys use?

When was Businys last checked?

Documentation

@businys/mcp-server

Installation

Claude Desktop

Other MCP clients

Getting an API Key

What's Included

Tools (221 total)

Resources

Tool Discovery

Environment Variables

Transport

Data & Privacy

License

Links