CLI

Your endpoint, linked in one command

The mcphosting-cli links Claude Code or Cursor to your hosted MCP endpoint and lets you file and review tasks without leaving the terminal. For driving a full Assistant run, call the runs API directly — see the API reference.

Install

npm install -g mcphosting-cli

Or run any command on demand with npx mcphosting-cli. Once installed, run mcphosting-cli login to authenticate with your Bearer mcph_* key.

Commands

mcphosting-cli login [--key mcph_...] [--url <site>]

Save and verify your Bearer mcph_* key. Prompts if you omit --key, then calls /api/v1/me so a bad key fails immediately rather than on your next command.

Example

$ mcphosting-cli login

Paste your BusinessMCP API key (mcph_...): ****************************
Site URL [https://businessmcp.com]:

Logged in to "Acme Inc" (growth plan). Config saved to ~/.mcphosting.json

mcphosting-cli link [claude|cursor|config]

Point a local AI client at your hosted MCP endpoint. With "claude" it shells out to the Claude Code CLI and registers the server for you; anything else prints.

Example

$ mcphosting-cli link claude

Added MCP server businessmcp to Claude Code.
Linked — Claude Code can now drive your BusinessMCP dashboard.

$ mcphosting-cli link cursor

Add this MCP server to your client config (Cursor: .cursor/mcp.json):

{
  "mcpServers": {
    "businessmcp": {
      "url": "https://businessmcp.com/api/mcp",
      "headers": { "Authorization": "Bearer mcph_..." }
    }
  }
}

mcphosting-cli whoami

Show which workspace and plan the saved key belongs to, and the site it targets.

Example

$ mcphosting-cli whoami

Workspace: Acme Inc
Plan:      growth
Key:       mcph_9f2a11c…
Site:      https://businessmcp.com

mcphosting-cli task create <title> | task list

File a task into the dashboard, or list the open ones. Accepts --dept and --message on create.

Example

$ mcphosting-cli task create "Audit paid social ROAS" --dept Marketing

Task created: th_7b21
https://businessmcp.com/dashboard/assistant

$ mcphosting-cli task list

[in-progress ] Marketing  Audit paid social ROAS
[todo        ] Sales      Follow up with inbound from Tuesday

mcphosting-cli status

Open task counts by status.

Example

$ mcphosting-cli status

Workspace tasks: 6 open
  todo: 4
  in-progress: 2

mcphosting-cli open

Print your dashboard URL.

Example

$ mcphosting-cli open

https://businessmcp.com/dashboard

Building an integration?

The CLI wraps the platform API. See the full reference for raw curl and JSON.

API reference