@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

1. Sign in at 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:

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

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

• Businys
• Documentation
• Issues
• MCP Server Card