Build with AK Toolkits 🚀

Official developer CLI and Model Context Protocol (MCP) server for creating, validating, previewing, and submitting product showcases on Build with AK (agentkit.best/build-with-ak).

Package: @bestagentkits/build-with-ak · Binaries: build-with-ak, build-with-ak-mcp

Overview

Build with AK Toolkits lets developers and AI coding agents publish rich, block-based product showcases to the AgentKit directory — from the terminal, from an interactive TUI studio, or autonomously via MCP.

• CLI — init, template, slug, media, pull, analytics, validate, diff, preview, push, submit, studio.
• Terminal Studio — keyboard-driven TUI for metadata, 12 block types, reorder, and review.
• Local preview — loopback 127.0.0.1 live-reload server and offline static HTML export.
• Dual-transport MCP server — local stdio for Cursor/Claude/OpenCode, and a Cloudflare Workers Streamable HTTP server with OAuth 2.1 (RFC 9728) + x-api-key.
• 12 layout blocks, 5 curated templates — includes YouTube video, owner-authored Activities, and server-measured Pulse; image fields require finalized asset UUIDs.
• Atomic CAS push & frozen submit — single-call PUT /listing with expectedDraftRevisionId, and moderation-frozen POST /submit.

Quick Start

# Install
npm install -g @bestagentkits/build-with-ak      # or: pnpm add -g / bun add -g

# Configure your customer API key (generate at agentkit.best → Customer Dashboard)
export AGENTKIT_API_KEY=ck_live_...
export AGENTKIT_ENV=staging                 # or production (default)

# Scaffold a workspace from a template
build-with-ak init --template saas_product_launch

# Upload media, validate, preview
build-with-ak media upload ./assets/logo.png --kind logo --ref logo
build-with-ak validate --ready
build-with-ak preview --watch

# Push (atomic CAS) then submit for moderation
build-with-ak push --yes
build-with-ak submit --yes

Every command accepts --json for machine-readable { ok, data?, error? } output and standardized exit codes (0 ok, 2 validation, 3 auth, 4 not found, 5 CAS conflict, 6 network).

Author video, activities, and pulse in build-with-ak.json using the existing validate/preview/push workflow. Activities start empty; add only real product updates with valid dates and optional safe public HTTPS links. Pulse accepts only a title alongside its type. Monitoring uses the published listing's websiteUrl and upstream server cron; local previews contain no check history or invented health metrics. See Block Schemas for fields and limits. There are no dedicated Activities, Pulse, or cron CLI commands.

Read your product page analytics without initializing a workspace:

build-with-ak analytics --json
build-with-ak analytics --from 2026-08-01 --to 2026-08-31 --listing-id <owned-listing-uuid> --json

Uses the existing API key (or global --api-key). Returns first-party totals and zero-filled daily UTC counts; default last 30 days, maximum 366. Views deduplicate IP + user agent per listing/day; outbound clicks count redirect requests; referralConversions is always null in totals and daily rows because conversion tracking is not instrumented. Report conversions as unavailable; do not infer conversions, conversion rates, or external product sales. MCP agents can call build_with_ak_get_analytics on either transport. Requires an upstream backend with GET /api/build-with-ak/listing/analytics; no target-extension flag is needed.

Agent & Marketplace Integrations

1. Claude Code & Claude Desktop Plugin

Install directly via Claude Plugin Marketplace:

claude plugin add bestagentkits/build-with-ak-toolkits

2. skills.sh (Agent Ecosystem)

Install the skill to your coding agent (Claude Code, Cursor, Codex, OpenCode, Amp) via skills.sh:

# Install to current project
npx skills add bestagentkits/build-with-ak-toolkits

# Or install globally across all supported agents
npx skills add bestagentkits/build-with-ak-toolkits -g -y

# Or use directly without installing
npx skills use bestagentkits/build-with-ak-toolkits --skill build-with-ak

3. Hosted Remote MCP Server (Streamable HTTP)

Connect an OAuth-capable Streamable HTTP MCP client to this URL. Its normal browser sign-in and consent flow grants access to your own account; analytics starts with build-with-ak:read, and write actions request additional consent:

{
  "mcpServers": {
    "build-with-ak": {
      "type": "http",
      "url": "https://bwak.agentkit.best/mcp"
    }
  }
}

For clients without browser OAuth, an optional x-api-key header remains supported. CLI and local stdio continue using your customer API key.

The hosted HTTP MCP endpoint above is separate from the optional webmcp.dev connection inside the website's active Studio editor. That browser connection edits the open draft through Studio autosave; it does not submit or publish. See MCP Setup for the boundary.

4. Local stdio MCP Server

Add to your local MCP client configuration:

{
  "mcpServers": {
    "build-with-ak": {
      "command": "npx",
      "args": ["-y", "--package=@bestagentkits/build-with-ak", "build-with-ak-mcp"],
      "env": {
        "AGENTKIT_API_KEY": "ck_live_...",
        "AGENTKIT_ENV": "production"
      }
    }
  }
}

5. OpenAI / ChatGPT Service Discovery

The live Cloudflare Worker provides standard discovery and schema manifests:

• AI Plugin Manifest: https://bwak.agentkit.best/.well-known/ai-plugin.json
• OpenAPI 3.1.0 Specification: https://bwak.agentkit.best/openapi.json
• OAuth 2.1 Metadata (RFC 9728): https://bwak.agentkit.best/.well-known/oauth-protected-resource
• Service Index: https://bwak.agentkit.best/

Documentation

• Quickstart
• CLI Reference
• MCP Setup
• Cloudflare Deployment
• OAuth 2.1 Configuration
• Release & NPM Publishing
• Block Schemas
• Media Guide
• Agent Skill: skills/build-with-ak/SKILL.md

Development

pnpm install
pnpm test:base      # base 11-endpoint contract suite (100% green)
pnpm test:target    # target extension endpoints (media library, slug availability)
pnpm build          # bundle CLI, MCP stdio, worker, and library
pnpm typecheck
pnpm sync:contracts # re-pin wire schemas from ak-web (intentional contract upgrades only)
pnpm check:drift    # verify committed snapshots match the pinned commit

Wire schemas are pinned from bestagentkits/ak-web at commit 6e548457dba509a39f875cb3fceffb2a5f722a1a and committed under src/contracts/generated/ with provenance digests in src/contracts/provenance.ts.

License

MIT © AgentKit