# 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
- Maker portal: https://taskbullet.com/hub/maker
- Consumer keys: https://taskbullet.com/hub/keys
- Transport: streamable HTTP (JSON-RPC)
- Auth: optional `x-api-key: tb_hub_…` (Bearer also accepted). Operators can require a key.

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

## Connect

### Claude Desktop

```
{
  "mcpServers": {
    "taskbullet-hub": {
      "url": "https://taskbullet.com/api/hub/mcp",
      "headers": { "x-api-key": "tb_hub_your_key" }
    }
  }
}
```

### Cursor

```
{
  "mcpServers": {
    "taskbullet-hub": {
      "url": "https://taskbullet.com/api/hub/mcp",
      "headers": { "x-api-key": "tb_hub_your_key" }
    }
  }
}
```

### Generic MCP

```
POST https://taskbullet.com/api/hub/mcp
Content-Type: application/json
Accept: application/json
x-api-key: tb_hub_your_key
```

### OpenClaw

```
https://taskbullet.com/api/hub/mcp
x-api-key: tb_hub_your_key
```

Send `x-api-key` when you have a hub key. `tb_live_` keys are for Agent MCP and are rejected here. The placeholder `tb_hub_your_key` is not a real key.

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, Agent API, or a phone call. A phone call is place_call on the calls wallet.
- `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.

Approved maker listings use their own namespace. They are routed only after an admin approves them and routing is turned on. Until then, `tools/list` is TaskBullet, Orca, and `taskbullet.human_backup`.

## 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`. A third-party phone call is `place_call` on Agent MCP, not `delegate_task`. Outside weekday 09:00–17:00 in the recipient time zone, `place_call` needs `allow_outside_business_hours: true` after the customer confirms.
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. A hub key also has its own per-minute cap. No paid AI calls.
- Upstream calls have a timeout and a response size cap.
- Built-in upstreams are allowlisted: taskbullet.com, ops.orcarw.com.
- Maker upstreams must be public https URLs. The gateway pins DNS and does not call private or metadata hosts. It does not forward the caller's hub key, cookies, or Authorization header.
- 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.
- `tools/call` counts are stored per key and per listing. A meter failure is logged and the tool result is still returned. This version does not invoice or pay anyone.

## List your MCP

The public form at https://taskbullet.com/hub saves a review request and emails wes@taskbullet.com. It does not publish a server.

A signed-in company manages a listing at https://taskbullet.com/hub/maker (name, description, remote MCP URL, logo, contact). New and edited listings stay pending until an admin approves them. Approval does not route the server until the routing flag is on.

## Not enabled

- Stripe usage billing. Counts are stored. See the repo design note `docs/hub-usage-billing.md`. No price is set.
- Maker payouts.
