# ChiefLab (remote · api.chieflab.io)

Open execution contract for agents doing business work. 6 operators, one MIT-licensed spec.

- Trust score: 66/100 (medium)
- Change this week: +10
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `api.chieflab.io`: 66/100 (this document), [markdown](https://verifymcp.io/servers/bdentech-chieflab/api-mcp.md), [page](https://verifymcp.io/servers/bdentech-chieflab/api-mcp)
- npm · `@chieflab/mcp-server`: 34/100, [markdown](https://verifymcp.io/servers/bdentech-chieflab/chieflab-mcp-server.md), [page](https://verifymcp.io/servers/bdentech-chieflab/chieflab-mcp-server)

## Channel facts

- Endpoint: `https://api.chieflab.io/api/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `0.3.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 89/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, but the challenge carries no valid RFC 9728 metadata, so a client cannot discover where to get a token.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 25/100
  - AI-judged instruction clarity (poor).
  - Context-footprint check failed: tool/resource definitions use about 12507 tokens (~277/item across 45 items; 45 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 96/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 88% of tool parameters carry a description.
- **Capabilities**: 40/100
  - Spec-recency check failed: implements MCP spec 2025-03-26; the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http bdentech-chieflab https://api.chieflab.io/api/mcp
```

### Codex

```toml
[mcp_servers.bdentech-chieflab]
url = "https://api.chieflab.io/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bdentech-chieflab": {
      "type": "remote",
      "url": "https://api.chieflab.io/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add bdentech-chieflab --url https://api.chieflab.io/api/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  bdentech-chieflab:
    url: "https://api.chieflab.io/api/mcp"
```

### Other

```json
{
  "mcpServers": {
    "bdentech-chieflab": {
      "type": "http",
      "url": "https://api.chieflab.io/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 65, +7)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 58, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 57, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 56, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 55)

First indexed and scored.

## MCP tools (45)

### `chieflab_help` (~89 tokens)

FIRST TOOL — call before anything else when you don't know what ChiefLab does or where to start. Returns the operator menu + workspace state (connectors wired, last run, signup status) + the single next action for this workspace. Cheap, no side effects. After this, call chieflab_launch_product for a full launch or chieflab_post for a single channel.

### `chieflab_get_users_after_build` (~534 tokens)

Outcome-named alias for chiefmo_launch_product. USE WHEN a coding agent just built, shipped, or deployed something and the user asks 'get users', 'find customers', 'make money from this', 'get paying users', 'get eyes on this', 'what now?', or 'how do I launch this?' This is the agent-dependency tool: after build, call this to turn the product into a repo-grounded money/distribution loop with launchPack, signed reviewUrl, approval-gated publish/send actions, 24h measurement, memory, next move, moneyLoop, and agentDependency. Gather repoContext first. Route exactly like chiefmo_launch_product; do not use chiefmo_diagnose_marketing for a new product.

Input parameters:

- `brand` (object): Optional inline brand context.
- `channels` (array): Optional launch channels. Default is auto-selected from the detected product playbook — service agencies skip Product Hunt; B2B SaaS / devtools / consumer / AI-agent products include it; internal too…
- `goal` (string): Desired outcome, e.g. 'Get first 100 users', 'find paying customers', 'get design partners', 'make money from this'.
- `idempotencyKey` (string): Optional dedupe key to prevent duplicate launch preparation.
- `includeFullArtifacts` (boolean): Alias for responseShape:"full". Backward-compat with older P29 clients.
- `outputMode` (string): context | draft | full | demo. 'demo' is the first-use / YC-demo concise mode — forces 4 punch-list channels (linkedin / x / product_hunt / email), draft rendering, no image gen, scrubbed inline draf…
- `productDescription` (string): Short product description if no public URL exists yet.
- `productUrl` (string): Live product URL. Pass either productUrl or productDescription.
- `repoContext` (object): Strongly recommended. Include whatChanged, recentCommits, changedFiles, routes, readme, targetCustomer, launchGoal.
- `responseShape` (string): summary (default, smallest — promotes launchId / launchRoomUrl / publishActionIds / firstResponseScript; per-channel draft bodies live behind the reviewUrl) | compact (per-channel previews + truncate…
- `tenantId` (string): Optional tenant/end-user id for stored brand context and memory.

### `chieflab_connect_provider` (~155 tokens)

Connect a third-party provider (Zernio, Resend, GA4, Search Console, HubSpot, Stripe, Linear, Notion, Slack) to this workspace. USE WHEN the user wants to wire up publishing, email sending, or analytics readback. For OAuth providers (ga4 / search_console / hubspot) returns an authorizeUrl the agent surfaces to the user. For API-key providers (zernio / resend) returns instructions for the set-key tool. Without this, publish/send/measure tools return 'configure first' errors.

Input parameters:

- `provider` (string, required): Provider id: zernio | resend | ga4 | search_console | hubspot | stripe | linear | notion | slack

### `chieflab_retry_blocked_action` (~114 tokens)

P13 — re-check a blocked publishAction's connector readiness. Returns whether the channel is now ready (so the agent can re-fire chiefmo_publish_approved_post / chiefmo_send_approved_email) or still blocked with the up-to-date connect path. USE WHEN the user has just connected a missing provider and the agent needs to know if the action can fire.

Input parameters:

- `actionId` (string, required): The blocked publishAction.id from chiefmo_launch_product.
- `workspaceId` (string)

### `chieflab_use_manual_fallback` (~466 tokens)

USE WHEN any launch action carries a manualFallback brief — either because the channel has no automated provider at all (Product Hunt, Hacker News, Reddit, Discord, Slack, Indie Hackers, dev.to, YC Bookface, blog) OR because the channel HAS an automated provider but its connector isn't wired yet for this workspace (LinkedIn / X without a Zernio key; email without a Resend key + verified sender domain). Pattern: use the inline fallback NOW to ship the launch manually; connect the provider LATER (each fallback returns an upgradePath with the exact connector wiring) so the same action publishes automatically on the next launch. Returns: paste-ready title + body, per-channel checklist (best time, format, first-comment script), capture-URL-after instruction, measurement template for the 24h readback, and the optional upgradePath when automation is available. Converts a 'blocked' channel into a 5-minute human-in-the-loop ship. Approval-gated upstream: the originating publishAction must already be 'approved' on the reviewUrl before this tool returns the brief.

Input parameters:

- `actionId` (string, required): The publishAction.id from chiefmo_launch_product whose manualFallback you want to fetch. Works for both manual-only channels (connector === 'manual_only') and otherwise-automated channels whose conne…
- `channel` (string): Override the channel inferred from the action. One of: linkedin | x | email | blog | landing_hero | product_hunt | hacker_news | reddit | discord | slack | indie_hackers | dev_to | ycombinator.
- `discordCommunity` (string): Optional. For channel=discord, which community (the brief tailors tone + announcement-channel pick).
- `subreddit` (string): Optional. For channel=reddit, which subreddit (e.g. 'r/SaaS', 'r/AI_Agents'). ChiefLab's brief picks the right post format per sub.
- `workspaceId` (string): Optional workspace id.

### `chieflab_set_company_profile` (~217 tokens)

P88 — set the workspace's persistent company profile. ChiefLab's pre-P88 brief pipeline was repo-first; without a repo, launches landed thin. P88 lets the founder (or an agent) store the company / product facts ONCE and every subsequent launch grounds in them, even URL-only / paste-description launches. Pass partial maps to update specific fields; pass null for a field to remove it. Profile fields the brief consumes: companyName, productName, offer, audience, market, positioning, services[], productType, brandColors {primary, accent, bg, text}, websiteUrl, contactEmail, socialLinks[], keyClaims[], voiceSample.

Input parameters:

- `confidence` (string): high | medium | low. Default 'medium'.
- `profile` (object, required): Partial profile object — top-level keys merge, nested objects shallow-merge, null values remove.
- `source` (string): manual | extracted | imported | autodetected. Default 'manual'.
- `workspaceId` (string): Optional workspace id.

### `chieflab_get_company_profile` (~58 tokens)

P88 — read the workspace's stored company profile. Returns { profile, source, confidence, updated_at }. Use before launch to confirm what ChiefLab will ground in.

Input parameters:

- `workspaceId` (string): Optional workspace id.

### `chieflab_list_specialists` (~80 tokens)

P87 — list the specialist agents ChiefLab can delegate to (design / video / research / outreach / seo / analytics). USE WHEN the user asks 'what can ChiefLab do beyond launch posts?' or before calling chieflab_request_specialist. Returns the kind + label for each so the caller can pick the right one.

### `chieflab_request_specialist` (~307 tokens)

P87 — delegate to a specialist agent. USE WHEN the launch needs more than copy: a graphic brief (kind='design'), a demo video shot list (kind='video'), a prospective-customer research plan (kind='research'), personalized outreach drafts (kind='outreach'), landing-page SEO recommendations (kind='seo'), or a verdict + recommended next move from measurement data (kind='analytics'). Specialists are deterministic stubs today — they return structured briefs / plans / drafts the founder can act on immediately. Future LLM-backed implementations swap in transparently. Each request creates an approval-gated action so the brief lands in the Launch Room. Pass runId for grounding in the originating launch's intelligence brief.

Input parameters:

- `autoCreateAction` (boolean): Default true. When true, creates an approval-gated action in actionStore so the brief lands in the Launch Room. When false, returns the specialist output without persistence (use for one-off / previe…
- `brief` (object): kind-specific brief fields (asset/channel for design; durationSeconds/platform for video; goal for research; contacts/channel for outreach; url/targetTerms for seo; metrics/channel for analytics)
- `kind` (string, required): design | video | research | outreach | seo | analytics
- `runId` (string): Optional. Source run id; the specialist grounds in that launch's brief (productName / audience / market / positioning).
- `workspaceId` (string): Optional workspace id.

### `chieflab_force_measurement_due` (~208 tokens)

P93 — admin escape hatch. Forces a proof_ledger row's measurement_due_at into the past so the cron's next tick picks it up. USE WHEN smoke testing the launch → measure → next-move chain without waiting 24h, OR an ops user needs to retry a stuck measurement. Gated by CHIEFLAB_ADMIN_TOKEN header (same gate as /api-keys/issue). Refuses if the row is already measured. Pass `dueAt` (ISO string) to set a specific time; defaults to now - 60s.

Input parameters:

- `adminToken` (string, required): Required. Must match CHIEFLAB_ADMIN_TOKEN env var.
- `dueAt` (string): Optional ISO timestamp. Defaults to (now - 60s) so the next cron tick picks it up.
- `proofId` (string, required): proof_ledger row id (from chieflab_record_manual_publish or chieflab_execute_approved_action response).

### `chieflab_persistence_health` (~160 tokens)

P91 — verify the persistent stores. Probes proof_ledger / publishing_targets / company_profiles tables (Supabase) OR confirms the in-memory fallback. USE WHEN the user just ran the SQL migrations and wants to confirm the API is now using durable storage; OR before a real founder launch to make sure data won't evaporate on cold start; OR when debugging why a previously-stored target / profile disappeared. Returns per-store: { kind: 'supabase'|'in_memory', durable: bool, tableExists?: bool, sampleQueryOk: bool, rowCount?: number, error?, warning? }. The 'tableExists: false' case means the SQL migration has NOT been run.

Input parameters:

- `workspaceId` (string)

### `chieflab_query_proof_ledger` (~215 tokens)

P80 — query the persistent proof ledger. USE WHEN the user (or a dashboard) asks 'what has ChiefLab actually shipped for this workspace?' or 'show me the launch history.' Returns the proof rows for executed publishes / sends / manual-posts with the artifact URLs, channels, execution modes, and measurement state. Persistent across cold starts when deps.proofLedgerStore is wired to Supabase; falls back to in-memory (warm function lifetime) otherwise.

Input parameters:

- `limit` (number): Page size (1-500, default 50).
- `measurementDueOnly` (boolean): When true, returns only rows with measurement_due_at <= now AND measured_at IS NULL. Use this to find what's ready for 24h readback.
- `runId` (string): Optional. Filter to one run's proofs.
- `sinceTimestamp` (string): Optional ISO timestamp; only return proofs published at or after.
- `workspaceId` (string): Optional workspace id (defaults to auth workspace).

### `chieflab_set_publishing_targets` (~222 tokens)

P79 — set per-workspace publishing target defaults so chiefmo_approve_action({ autoExecute: true }) doesn't need the agent to pass platform / recipient ids on every call. One-time setup per workspace. channelTargets is a map { linkedin: { accountId }, x: { accountId }, email: { fromEmail, recipientListId } }. Pass partial maps to update specific channels; pass `null` for a channel value to remove it. Persisted via deps.publishingTargetsStore when wired, otherwise in-process Map (Vercel function lifetime). Returns the merged channelTargets + storage location ('persistent' or 'in_memory').

Input parameters:

- `channelTargets` (object, required): Map of channel → target. Examples: linkedin/x → { accountId: '<zernio_account_id>' }; email → { fromEmail: 'founder@product.com', recipientListId: '<list_id>' }. Pass null as a channel value to remov…
- `workspaceId` (string): Optional workspace id (defaults to the auth workspace).

### `chieflab_get_publishing_targets` (~82 tokens)

P79 — read the workspace's stored publishing target defaults. Returns { channelTargets, store }. Useful before launch so the agent can surface 'You haven't connected an Instagram account yet — set it via chieflab_set_publishing_targets' instead of blocking on first auto-execute.

Input parameters:

- `workspaceId` (string): Optional workspace id.

### `chieflab_suggest_next_move` (~297 tokens)

P75 — Next Move Engine. USE WHEN measurement just came in (chiefmo_post_launch_review fired automatically at 24h, OR the user manually called it) and you want to know what the operator should do next. Reads metrics + the original launch's brief and emits a deterministic suggestion: {kind: 'follow_up_email' | 'founder_dm' | 'thread_reframe' | 'landing_iteration' | 'lessons_learned_post' | 'seo_title_test' | 'wait' | 'noop', priority, reasoning, draftBrief: {channel, headline, body, cta?, recipients?}, measurementGroundingFacts}. Pure-function; same input → same output, no LLM. Pair with chieflab_create_next_move_action to turn the suggestion into an approval-gated draft.

Input parameters:

- `channel` (string, required): Channel the measurement is for (linkedin, x, email, landing_hero, product_hunt, hacker_news).
- `metrics` (object, required): Measurement metrics — engagements, clicks, opens, replies, traffic, conversions, upvotes, rank, etc. Synonyms (engagement / openRate / clickRate / visits) are accepted.
- `runId` (string): Optional. Source run whose brief grounds the suggestion (so the draft references the actual product / market / audience instead of templates).
- `workspaceId` (string): Optional workspace id.

### `chieflab_create_next_move_action` (~220 tokens)

P75 — turn a Next Move suggestion into an approval-gated draft action. USE WHEN you've called chieflab_suggest_next_move and the suggestion's kind is not 'wait' or 'noop'. Creates an actionStore entry with status='awaiting_approval', the suggested draft body inline, and an executionMatrix that points at the right next-execution path. The reviewer sees the new card in the Launch Room / IDE chat like any other approval card — same approve / revise / reject flow. Closes the loop: launch → measure → next move → approve → execute → repeat.

Input parameters:

- `channel` (string, required): Channel the measurement was for (used to ground the suggestion).
- `metrics` (object, required): Same metrics object passed to chieflab_suggest_next_move.
- `runId` (string, required): Required. The originating run id (the next-move action is tagged with this so the brain can compound launch → measure → next-move chains).
- `workspaceId` (string): Optional workspace id.

### `chieflab_regenerate_visual_asset` (~382 tokens)

P72 — regenerate a single visual asset (LinkedIn graphic, X graphic, landing hero, etc.) with a different style / fidelity / headline / model. USE WHEN a reviewer hits 'Regenerate' on a launch image in the Launch Room. Reads the original launch's brief from the run metadata, calls produceVisualAsset with the new parameters, and returns the updated asset shape (assetId, dataUrl, dimensions, prompt, mode). Does NOT auto-persist back to the run — caller decides whether to swap the asset in place (via runStore) or treat the regen as a parallel candidate.

Input parameters:

- `assetId` (string): Optional original assetId — when present, the regenerated asset reuses the id so the run viewer can swap in place.
- `brandColors` (object): Optional {primary, accent, bg, text} hex override.
- `channel` (string, required): Channel the asset is for (linkedin / x / email / landing_hero / etc.).
- `cta` (string): Override the CTA text.
- `fidelity` (string): on_brand | polished | experimental. Defaults to 'on_brand'.
- `headline` (string): Override the headline rendered into the image.
- `model` (string): gemini-2.5-flash-image | gemini-3-pro-image-preview. Caller override; defaults to the model the brief's fidelity selects.
- `runId` (string, required): Launch run id that produced the original asset. Used to look up the LaunchIntelligenceBrief stored on the run.
- `seed` (string): Optional seed string for deterministic layout-hint picking.
- `style` (string): clean | bold | editorial | playful. Defaults to 'editorial'.
- `subheadline` (string): Override the subheadline.
- `workspaceId` (string): Optional workspace id.

### `chieflab_record_manual_metrics` (~322 tokens)

P116 — paste-what-you-see metric fallback for channels without public-API measurement (X, LinkedIn, Email, landing pages, Product Hunt). USE WHEN a published action's channel doesn't have a public-JSON metrics endpoint (anything except hacker_news / reddit) AND the founder is ready to paste the visible numbers. Reads metadata.proof.artifactUrl to confirm the post is recorded, writes the provided metrics into metadata.proof.metrics + measuredAt, auto-classifies the outcome (channel-specific thresholds: X needs likes/replies, LinkedIn needs reactions/comments, Email needs opens/clicks/replies, etc.), and creates next-move actions just like the auto-measurement path. Returns the metric schema for the channel so callers can render the right form fields.

Input parameters:

- `actionId` (string, required): The action id to attach metrics to.
- `force` (boolean): Re-record even if metadata.proof.measuredAt is already set. Default false.
- `metrics` (object): Free-form metrics map. Channel-specific keys: x → {impressions, likes, replies, retweets, clicks}; linkedin → {impressions, reactions, comments, reposts, clicks}; email → {sent, opens, clicks, replie…
- `workspaceId` (string): Optional workspace id.

### `chieflab_measure_reddit` (~192 tokens)

P115 — pull a Reddit post's score + comments + upvote ratio + top replies via the public Reddit JSON API and write them to the action's metadata.proof. USE WHEN a published Reddit action is ripe for 24h measurement. Parses subreddit + post id from the publishedUrl, calls https://www.reddit.com/r/<sub>/comments/<id>.json (no auth), auto-creates next-move actions based on the outcome (trending → reply + cross-post; engaged → reply; downvoted → rewrite angle). Idempotent — second call returns existing measurement unless force:true.

Input parameters:

- `actionId` (string, required): The action id whose publishedUrl points at the Reddit post. Required.
- `force` (boolean): Re-measure even if metadata.proof.measuredAt is already set. Default false.
- `workspaceId` (string): Optional workspace id.

### `chieflab_measure_hacker_news` (~188 tokens)

P109 — pull a Hacker News post's score + comments + top replies via the public HN API and write them to the action's metadata.proof. USE WHEN a published Hacker News action is ripe for 24h measurement (checks the publishedUrl on the action, parses the item id, calls the Firebase API). Auto-creates a next-move action based on the outcome (trending → reply + cross-post; engaged → reply; stalled → rewrite angle). Idempotent — second call returns the existing measurement. No API key required; HN is public-read.

Input parameters:

- `actionId` (string, required): The action id whose publishedUrl points at the HN post. Required.
- `force` (boolean): Re-measure even if metadata.proof.measuredAt is already set. Default false.
- `workspaceId` (string): Optional workspace id.

### `chieflab_review_visual_asset` (~216 tokens)

P104 — approve or reject a single visual asset (LinkedIn graphic / X image / landing hero / Product Hunt gallery / carousel slide). USE WHEN a reviewer hits 'Approve' or 'Reject' on a launch image in the Launch Room. Reads the run's stored visualAssets list, updates the matching asset's status (approved | rejected | pending_approval), persists the change to run metadata so future loads + the channel-media render reflect the decision. Companion to chieflab_regenerate_visual_asset (which produces an updated asset shape without persisting).

Input parameters:

- `assetId` (string, required): The visual asset id from launchPack.channels[channel].media[*].assetId.
- `decision` (string, required): approve | reject. Updates the asset's status field.
- `reason` (string): Optional. Why rejected (or why approved). Stored in metadata for audit + future brain memory.
- `runId` (string, required): Launch run id that produced the asset.
- `workspaceId` (string): Optional workspace id.

### `chieflab_execute_approved_action` (~415 tokens)

P71 — closed-loop executor wrapper. USE WHEN chiefmo_approve_action just succeeded on an action whose executionMatrix.mode is oauth_connector or api_key_connector AND connectorReady is true. Routes to the right native executor (chiefmo_publish_approved_post for social / chiefmo_send_approved_email for email), runs the execute-time sanity gate (re-classifies the action's stored body to catch DEGRADED MODE / clarification / refusal text that slipped through draft-time classification), captures the executor's result, writes a standardized metadata.proof shape ({executedAt, artifactUrl, artifactId, executionStatus, failureReason, measurementDueAt}) on the action, and schedules the 24h followup via launchFollowupStore so chiefmo_post_launch_review fires automatically. Returns a uniform shape regardless of channel so the agent / Launch Room doesn't have to branch on connector type. For manual_handoff actions, returns guidance to call chieflab_record_manual_publish with the live URL instead. For blocked actions, returns the connector-wiring instruction.

Input parameters:

- `actionId` (string, required): The publishAction.id whose executionMatrix you want to execute. The action must be in status='approved' (call chiefmo_approve_action first).
- `mediaUrls` (array): Optional media URLs (image / video) for social posts. Zernio uploads them to its CDN before posting.
- `platforms` (array): For oauth_connector (social): Zernio platform descriptors, e.g. [{platform: 'linkedin', accountId: '<id>'}]. Required for social posts unless the workspace has a default mapping; the tool refuses wit…
- `recipients` (array): For api_key_connector (email): recipient email addresses. Required for email sends unless the action carries a stored recipient list.
- `subject` (string): For email sends: subject line override. Defaults to the action's stored subject when present.
- `workspaceId` (string): Optional workspace id.

### `chieflab_check_measurement_due` (~176 tokens)

P71 — measurement queue inspector. USE WHEN the agent wants to know which executed actions are ready for their 24h readback (regardless of how they were executed — native connector OR manual paste). Lists actions where metadata.proof.measurementDueAt <= now AND metadata.proof.measuredAt is unset. Returns: [{actionId, runId, channel, executedAt, measurementDueAt, artifactUrl, executionStatus, recommendedNextTool}]. Pairs with chiefmo_post_launch_review which the cron also calls automatically; this tool surfaces the same queue to a foreground agent so it can opportunistically pull metrics during a session instead of waiting for the next cron tick.

Input parameters:

- `runId` (string): Optional. Restrict to one run.
- `workspaceId` (string): Optional workspace id.

### `chieflab_skip_next_move` (~143 tokens)

P142 — founder rejects a next-move recommendation without doing it. Captures a reason so the brain learns which kinds of moves don't fit this workspace (e.g. 'we don't cross-post to Reddit on principle' / 'we tried DMs already'). Flips action to rejected with metadata.skipReason. The next-move generator reads recent skip reasons before suggesting moves of the same kind on this workspace.

Input parameters:

- `actionId` (string, required): The next-move action id.
- `reason` (string): Why the founder is skipping this. Used by the brain to avoid suggesting similar moves.
- `workspaceId` (string): Optional workspace id.

### `chieflab_mark_action_done` (~176 tokens)

P135 — mark a next-move action as completed when the founder has done the move BUT there's no URL to record (e.g. reply_to_commenters, dm_engagers, mark replies done). Flips the action to executed with metadata.markedManuallyAt + metadata.executedManually=true. The next-move card disappears from /command/'s Today's Loop. For moves that DO have a URL (cross-post, new post), use chieflab_record_manual_publish instead — it both records the URL and marks executed.

Input parameters:

- `actionId` (string, required): The next-move action id.
- `note` (string): Optional founder note about what was done. Stored in metadata.markedManuallyNote for the brain to read later.
- `workspaceId` (string): Optional workspace id.

### `chieflab_record_manual_publish` (~281 tokens)

USE WHEN the user has manually posted to a channel returned by chieflab_use_manual_fallback (Product Hunt / HN / Reddit / Discord / etc.) and wants to feed the live URL back to ChiefLab so the closed loop continues. Records the URL on the original publishAction (status flips from 'approved' to 'executed' with metadata.executedManually=true + metadata.publishedUrl), persists a proof_asset to the P9 company brain, and queues 24-hour metrics readback via chiefmo_post_launch_review. Without this tool, manually-posted channels are lost to ChiefLab's measurement loop.

Input parameters:

- `actionId` (string, required): The publishAction.id that the user manually published (from chieflab_use_manual_fallback). Required.
- `notes` (string): Optional. Any context on how the post performed in the first hour (early upvotes, top comment, reactions). Persists into the P9 brain.
- `publishedAt` (string): Optional ISO 8601 timestamp. Defaults to now.
- `publishedUrl` (string, required): The live URL of the manual post (e.g. producthunt.com/posts/<slug>, news.ycombinator.com/item?id=<id>, reddit.com/r/SaaS/comments/<id>).
- `workspaceId` (string): Optional workspace id.

### `chieflab_connector_status` (~80 tokens)

USE WHEN the user just completed a connector OAuth flow and you want to confirm it succeeded — 'did my connection work?', 'is my Zernio/HubSpot/Stripe connected?'. Returns status: pending | connected | failed for the given connectionId.

Input parameters:

- `connectionId` (string, required)
- `workspaceId` (string)

### `chieflab_signup_workspace` (~230 tokens)

USE WHEN the user has no ChiefLab API key yet and you've gotten a 401 / 'authentication required' error from any other tool. Agent-first signup: creates a new workspace and returns the API key inline as `apiKey`. PREFERRED flow: use your filesystem tools to write the apiKey into the user's MCP config (see mcpConfigSnippet for the patch shape), then ask the user to restart their runtime once. After restart, re-call the original tool. FALLBACK: if you can't write to the config file, surface the included deliveryUrl to the user — they click, see the key, paste it manually. URL expires in 1 hour, single-use, IP-rate-limited (5/IP/hr). No login form.

Input parameters:

- `agentName` (string): Optional: which AI agent is requesting (Cursor, Claude Desktop, Codex, custom). Logged for support.
- `contactEmail` (string): Optional contact email for the user (used for future notifications).
- `workspaceLabel` (string): Optional human-readable label for the workspace (default: 'default').

### `chieflab_launch_product` (~202 tokens)

Operator: chieflab-launch (primary). Spec v0.1 reference implementation of the orchestrator. End-to-end launch loop: repo-grounded positioning + per-channel drafts (linkedin, x, hn, reddit, email, landing_hero, product_hunt) + image briefs + approval-gated publishActions + signed reviewUrl + 24h measurement queue. Internally composes chieflab-post + chieflab-email under one runId. Spec-renamed alias of chiefmo_launch_product (backwards-compat retained).

Input parameters:

- `brand` (object)
- `channels` (array)
- `goal` (string)
- `idempotencyKey` (string)
- `imagesNeeded` (number)
- `productUrl` (string)
- `repoContext` (object)
- `tenantId` (string)
- `webhookUrl` (string)
- `workspaceId` (string)

### `chieflab_redraft` (~206 tokens)

USE WHEN the user says 'make this more casual' / 'shorter' / 'less salesy' / 'add a specific number' / 'redraft this' about a published draft. Pulls the existing brief for the actionId, merges the instruction, returns an updated brief your LLM should render. After rendering call chieflab_record_rendered_copy({ assetId, body }) to commit. Multi-turn flow stays coherent: each redraft increments action.metadata.revision; original brief preserved in metadata.history.

Input parameters:

- `actionId` (string, required): The publishAction.id from chiefmo_launch_product.
- `body` (string): Optional. If your LLM already rendered the redrafted body, pass it here and ChiefLab updates the action's brief directly.
- `instruction` (string, required): Plain-English instruction. 'shorter', 'more casual', 'add the $40 number from our pricing page', etc.
- `workspaceId` (string)

### `chieflab_set_provider_key` (~185 tokens)

Store a provider API key for THIS workspace. Once stored, ChiefLab uses your key (BYOK — you pay the provider directly, no markup). Without it, ChiefLab uses its own key and bills through with a margin. Providers: gemini (image gen), resend (email), zernio (social publish), anthropic (LLM, future), openai (LLM, future). Stored encrypted at rest. Use chieflab_revoke_provider_key to remove. The key never leaves this workspace.

Input parameters:

- `apiKey` (string, required): The provider API key (e.g. for Gemini: a Google API key starting with AIza...).
- `provider` (string, required): gemini | resend | zernio | anthropic | openai
- `workspaceId` (string): Optional workspace id (defaults to your bearer's workspace).

### `chieflab_inbox` (~169 tokens)

USE WHEN the user asks 'what came in from my launches?' / 'show me my replies' / 'what's in my inbox?' / 'who responded to the LinkedIn post?'. Returns engagement events for THIS workspace, ordered by recency. Filter by status (new / drafted / approved / sent / dismissed) — default new. Pair with chieflab_draft_reply to handle them.

Input parameters:

- `limit` (number): Max events to return. Default 50.
- `sinceHours` (number): Only events received in the last N hours. Default 168 (7 days). Max 720 (30 days).
- `status` (string): new | drafted | approved | sent | dismissed | all (default: new)
- `workspaceId` (string)

### `chieflab_status` (~242 tokens)

SESSION-RECOVERY · FIRST CALL when a session starts and the user mentions launch / users / growth / customers / metrics / revenue / marketing / what next / shipping. Returns a command-center bootCard with `headline`, `priority`, `cards[]` (each carries kind + label + literal user command + runHandle), and `next` (the one-line prompt). Aggregates: pending approvals + ripe measurements + new engagement + queued prospects + recent launches + manual-publish-pending actions. ChiefLab is stateful and re-summonable — even if the conversation was lost, the IDE was switched, or the runId was forgotten, this call recovers the workspace business state. If the user asked to launch the CURRENT repo, compare boot cards to currentRepoContext/projectName; if the open loop is unrelated, start a fresh launch instead of resuming stale work.

Input parameters:

- `currentRepoContext` (object): Optional current repo/project context. Helps agents compare recovered loops against the project the user is asking about.
- `projectName` (string): Optional current project/repo name.
- `workspaceId` (string): Optional workspace id.

### `chieflab_boot` (~146 tokens)

Alias of chieflab_status. Use as the FIRST tool when an agent session starts on a workspace that already has activity — recovers all open business loops with literal user commands. Same response shape as chieflab_status, same handler. If the user asked to launch the current repo and a recovered open loop looks unrelated, do not blindly resume it; start a fresh launch for the current repo.

Input parameters:

- `currentRepoContext` (object): Optional current repo/project context. Helps agents compare recovered loops against the project the user is asking about.
- `projectName` (string): Optional current project/repo name.
- `workspaceId` (string): Optional workspace id.

### `chieflab_verify_install` (~195 tokens)

POST-INSTALL HEALTH CHECK. Call this exactly once after the agent has wired ChiefLab into the runtime (per the bootstrap protocol at https://chieflab.io/bootstrap.txt). Returns { ok, mcpReachable, toolsDiscovered, visibleFrontDoorTools, callableInternalTools, workspaceReady, hasOpenLoops, blockedConnectors, summary }. `toolsDiscovered` means the visible front-door catalog, not every internal/back-compat callable handler. The `summary` is one sentence the agent should paste verbatim to the user — e.g. 'ChiefLab installed and ready. Workspace fresh, no open loops, all channels need connectors before auto-publish.' Do NOT list every internal tool — render the summary only. If `ok` is false, the response includes a `nextStep` describing the single recovery action.

Input parameters:

- `workspaceId` (string): Optional workspace id; inferred from bearer auth.

### `chieflab_brain_summary` (~125 tokens)

USE WHEN the user asks 'what do you remember about my brand?' / 'show me my brain' / 'what have you learned?'. Returns a plain-English paragraph summarizing what the per-workspace brain has accumulated: launch count, top-performing channels, brand voice patterns from approved drafts, what's been rejected and why, channel-specific performance, recent proof points. The moat made visible. Pair with chieflab_brain_read for the raw structured data.

Input parameters:

- `tenantId` (string): Optional tenant scope.
- `workspaceId` (string)

### `chieflab_search_capabilities` (~147 tokens)

USE WHEN your operator needs a capability outside its own scope and wants to find another operator that can fulfill it — 'find me a demo-video capability', 'who can do SEO audits', 'search for design help'. Returns active capability records ranked by recency. Pair with chieflab_create_work_request to actually request bounded work from the chosen operator. The discovery embryo for an agent-native marketplace.

Input parameters:

- `capability` (string): Capability slug to match (exact match — e.g. 'demo_video').
- `limit` (number): Max results. Default 25.
- `tags` (array): Tag overlap filter (e.g. ['video', 'demo']).

### `chieflab_get_capability` (~70 tokens)

USE WHEN you have a specific operatorId + capability and want the full machine-readable profile (inputs, outputs, pricing, approval-required flag, endpoint). Pre-flight check before chieflab_create_work_request.

Input parameters:

- `capability` (string, required)
- `operatorId` (string, required)

### `chieflab_create_work_request` (~282 tokens)

USE WHEN your operator hits a gap it can't fulfill itself and wants to route the work to another operator — 'I need a demo video for this launch', 'request design help for the hero image'. Creates an open work request that other operators can offer against. Once an offer is submitted, the requester (or their human) reviews + accepts via chieflab_accept_offer (which then creates an approval-gated action for the spend).

Input parameters:

- `brief` (object): Structured brief — { goal, references, constraints, asset_links, etc. }. The more specific, the better the offers.
- `budget` (object): Optional. { kind: 'max_usd', amount: 50 } | { kind: 'quote' } | { kind: 'free' }.
- `capabilityNeeded` (string, required): Capability slug to match (e.g. 'demo_video'). Should match a published capability — call chieflab_search_capabilities first if unsure.
- `deadline` (string): Optional ISO 8601 timestamp.
- `sourceOperatorId` (string): Optional. The operatorId that's requesting (e.g. 'chieflab-launch').
- `sourceRunId` (string): Optional. The parent runId this work attaches to (e.g. the launch that needs the asset).
- `workspaceId` (string)

### `chieflab_approve_action` (~474 tokens)

[chieflab_* alias of chiefmo_approve_action] Approve one ChiefMO publish/send action so its executor can fire. USE WHEN the user — in IDE chat — said 'approve <channel>' (e.g. 'approve linkedin', 'approve hn'), 'approve all', 'ship it', 'go ahead', or otherwise greenlit a specific draft you rendered. Match the user's words to the channel, look up agentGuide.renderInChat[channel].actionId from the launch response, and call this tool with that actionId. This is the IDE-native approval path — no need to push the user to the reviewUrl. Pass `actionId` (preferred) or `id` (legacy alias). P74: pass `autoExecute: true` AND the connector inputs (`platforms` for social / `recipients` + `subject` for email) to have the approval chain directly into execution — approve and ship in one tool call. Without autoExecute (or when connector is manual_handoff / blocked), the response includes executionPlan and the caller is expected to invoke the suggestedTool next.

Input parameters:

- `actionId` (string): The action id from publishActions[].id in a launch_product response. Preferred.
- `autoExecute` (boolean): P74. When true AND the action's executionMatrix.mode is oauth_connector / api_key_connector / native_api AND the connector is ready, the approve handler immediately invokes chieflab_execute_approved_…
- `id` (string): Legacy alias for actionId.
- `mediaUrls` (array): P74. Optional media URLs for the social post — auto-uploaded to Zernio's CDN before publishing.
- `platforms` (array): P74. For autoExecute on social channels: Zernio platform descriptors, e.g. [{platform: 'linkedin', accountId: '<id>'}]. Required when autoExecute=true and mode=oauth_connector.
- `recipients` (array): P74. For autoExecute on email: recipient email addresses.
- `subject` (string): P74. For autoExecute on email: subject line override.

### `chieflab_continue_launch_loop` (~217 tokens)

[chieflab_* alias of chiefmo_continue_launch_loop] Resume a ChiefLab launch loop from runId. USE WHEN an agent has already called chieflab_get_users_after_build / chiefmo_launch_product and needs the exact next action: surface reviewUrl, execute an approved action, wait for measurement, measure results, or prepare the next move. Default response is summary-sized: reviewUrl + action ids, not full draft bodies. Pass responseShape:"full" only for debug/export.

Input parameters:

- `includeFullArtifacts` (boolean): Alias for responseShape:"full". Use only for debug/export.
- `responseShape` (string): summary (default, small — returns reviewUrl + openApprovalIds without draft bodies) | full (inline full approval objects; large, debug/export only).
- `runId` (string, required): The launchId/runId returned by chieflab_get_users_after_build or chiefmo_launch_product.
- `workspaceId` (string): Optional workspace id. Hosted auth usually supplies this.

### `chieflab_post_launch_review` (~247 tokens)

[chieflab_* alias of chiefmo_post_launch_review] USE WHEN ≥24h has passed since chiefmo_publish_approved_post fired and the user asks 'how did the launch perform?', 'what worked?', 'metrics from my launch'. Closes the loop: pulls 24h+ engagement (likes / comments / views / shares / follower delta) for posts in the launch run + recommends next iteration (rewrite, refresh creative, double down, pause). Returns per-account analytics + top posts + best-time-to-post + a structured next-move recommendation brief.

Input parameters:

- `accountIds` (array): Optional. Specific Zernio accountIds to pull analytics for. Defaults to all accounts that posted in this launch.
- `lookbackDays` (number): How many days of history to consider (default 7, max 90).
- `outputMode` (string): "context" (default): returns metrics + a brief your LLM renders into the customer-facing recommendation. "full": ChiefLab generates the recommendation server-side.
- `runId` (string, required): The launchId returned by chiefmo_launch_product. Used to scope analytics to posts from that launch.

### `chieflab_prepare_next_move` (~291 tokens)

[chieflab_* alias of chiefmo_prepare_next_move] USE WHEN the user has just published a launch (or ≥24h post-launch) and asks 'what's next?', 'follow-up post?', 'iterate on this', 'plan day 2'. P13 — turns one launch into a 7-day launch mode: drafts a queue of follow-up actions (day 2 reply post, day 3 case study, day 5 metrics share, day 7 retrospective) grounded in the prior launch's runId, the per-tenant brand voice + repo facts + channel performance from the P9 company brain, and the prior recommendation (so the next move doesn't repeat the last one). Returns a draft queue + signed reviewUrl + the standard agentGuide block. Each next-move action lands in awaiting_approval; nothing fires without explicit human approval.

Input parameters:

- `channels` (array): Optional. Restrict next-moves to these channels. Defaults to the channels of the prior launch.
- `horizon` (string): "day_2" | "day_3" | "week" — how far to plan. Default: "week" (7-day mode).
- `runId` (string, required): The prior launchId returned by chiefmo_launch_product. The prepared queue grounds in this run's measurement + memory.
- `workspaceId` (string): Optional workspace id.

### `chieflab_publish_approved_post` (~254 tokens)

[chieflab_* alias of chiefmo_publish_approved_post] Publish an approved social post (LinkedIn / X / Threads / Instagram / Facebook / Bluesky / TikTok) through the social publishing rail (current adapter: zernio). USE WHEN the user has approved a publishAction from chiefmo_launch_product on the reviewUrl and you need to fire the post. Strict approval gate: returns { reason: 'requires_approval', reviewUrl } if the action isn't approved yet. Once executed, returns the live platform post URL. Money/external-system action — never call this without an approved actionId.

Input parameters:

- `actionId` (string, required): The publishAction.id from chiefmo_launch_product. Required.
- `content` (string, required): The final rendered post text (your LLM rendered this from the brief in the launch pack).
- `mediaUrls` (array): Optional. Image/video URLs (or base64 data URLs from launch graphics).
- `platforms` (array, required): Which platforms + Zernio accountIds to publish to. Get accountIds from chieflab_list_publish_accounts.
- `scheduleAt` (string): Optional ISO 8601. Schedule for later instead of immediate.

### `chieflab_send_approved_email` (~246 tokens)

[chieflab_* alias of chiefmo_send_approved_email] Send an approved launch email through the email sending rail (current adapter: resend). USE WHEN the user has approved an email publishAction from chiefmo_launch_product and you need to fire the send. Strict approval gate (same shape as chiefmo_publish_approved_post). `from` MUST be on a domain verified at the adapter (resend.com) — check chieflab_list_email_senders first. Single recipient or short list (≤50). Money/external-system action — once sent cannot be unsent.

Input parameters:

- `actionId` (string): The publishAction.id from chiefmo_launch_product. Required for the approval gate to fire.
- `from` (string, required): Sender. Must be a verified Resend domain address (e.g. 'Brand <hi@yourdomain.com>').
- `html` (string): HTML body (preferred for inboxing).
- `replyTo`: Optional reply-to address(es).
- `subject` (string, required)
- `text` (string): Plain-text fallback (recommended).
- `to` (required): Recipient(s). Single email or array (≤50).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/bdentech-chieflab/api-mcp#diagnostics

## Score history

- 2026-08-03: 66
- 2026-08-02: 66
- 2026-08-01: 65
- 2026-07-31: 65
- 2026-07-30: 58
- 2026-07-29: 57
- 2026-07-28: 57
- 2026-07-27: 56
- 2026-07-26: 55

## Links

- Remote endpoint: https://api.chieflab.io/api/mcp
- Authorisation metadata: https://api.chieflab.io/.well-known/oauth-protected-resource/api/mcp
- Website: https://chieflab.io/
- Changelog RSS feed: https://verifymcp.io/servers/bdentech-chieflab/api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/bdentech-chieflab/api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/bdentech-chieflab/api-mcp