# TaskBullet Hub

TaskBullet Hub is a remote MCP gateway. Tool makers plug an MCP server in. An agent connects once and calls every tool through one endpoint. Each tool is namespaced by server.

- Endpoint: https://taskbullet.com/api/hub/mcp
- Page: https://taskbullet.com/hub
- Transport: streamable HTTP (JSON-RPC)
- Auth: none in this version

This is not the VA handoff. Delegation stays on https://taskbullet.com/api/agent-mcp with an `x-api-key`. The hub does not call a model, place an order, or spend hours.

## Connect

- Claude: `https://taskbullet.com/api/hub/mcp`
- ChatGPT: `https://taskbullet.com/api/hub/mcp`
- Cursor: `{"mcpServers":{"taskbullet-hub":{"url":"https://taskbullet.com/api/hub/mcp"}}}`
- OpenClaw: `https://taskbullet.com/api/hub/mcp`

OpenClaw's VA skill is still `openclaw skills install @griffmurder/taskbullet`. That skill is the handoff. This URL is the hub.

## Servers

### TaskBullet

Public TaskBullet site catalog. Read-only marketing tools. Not the VA handoff.

- Upstream: https://taskbullet.com/api/mcp
- Namespace: `taskbullet.*`
- `taskbullet.understand_site` — What TaskBullet is and who the site is for.
- `taskbullet.match_intent` — Classify hire, job seeker, existing client, or Agent API.
- `taskbullet.list_services` — VA service categories and common tasks.
- `taskbullet.get_pricing` — PH and US bucket pricing and the free-trial URL.
- `taskbullet.recommend_path` — Canonical URL for a known goal.

### Orca

Public Orca site catalog. Read-only pages, prices, and signup links.

- Upstream: https://ops.orcarw.com/api/mcp
- Namespace: `orca.*`
- `orca.understand_site` — What Orca is and who the site is for.
- `orca.match_intent` — Classify a public-site question and return the next URL.
- `orca.list_services` — Public Orca service and region pages.
- `orca.get_pricing` — Public marketplace, Team OS, Training, and Scout prices.
- `orca.list_faqs` — Public FAQ answers.
- `orca.recommend_path` — Canonical public URL for a known goal.
- `orca.get_signup_link` — Signup or onboarding URL. Does not create an account.

## taskbullet.human_backup

Local hub tool. When a task is stuck (phone, captcha, 2FA, physical world, subjective QA, or long manual work), it tells the agent how to hand the work to a TaskBullet VA through the existing delegate flow:

1. The human needs an account (https://taskbullet.com/get-started) and a `tb_live_` key.
2. Call `get_balance` on Agent MCP, confirm spend, then `delegate_task`.
3. `awaiting_customer_start` means the customer starts the job on Work. The VA has not started.
4. Poll `get_task` until completed, failed, or cancelled. Never invent a VA result.
5. Never send passwords, OTP codes, recovery keys, cookies, or API keys.

`taskbullet.human_backup` does not file the job.

## Safety

- Same per-IP and daily caps as the public site MCP at https://taskbullet.com/api/mcp. No paid AI calls.
- Upstream calls have a timeout and a response size cap.
- The gateway only calls allowlisted hosts: taskbullet.com, ops.orcarw.com.
- Each call is logged as server, tool, latency, and status. Arguments, headers, and secrets are not logged.
- A failed upstream is omitted from `tools/list`. The other servers and `taskbullet.human_backup` still return.

## List your MCP

The form at https://taskbullet.com/hub saves the submission and emails wes@taskbullet.com. Submissions are reviewed manually. The hub does not publish a server from the form.

## Not in this version

- TODO: maker API keys
- TODO: usage billing
- TODO: maker payouts