Documentation & Guide

How to Submit to Build with AK

Everything you need to showcase your product on the official AgentKit Directory. Choose visual authoring in our Web Studio, automate with our developer CLI, or let your AI Coding Agent submit autonomously via MCP.

Method 1: Web Studio

Interactive browser builder with 5 layout templates, 9 drag-and-drop block types, and live mobile/web preview.

Visual Guide

Method 2: CLI Toolkits

Command-line suite (@agentkit/build-with-ak) to scaffold, validate, diff, and push from terminal.

CLI Commands

Method 3: MCP Server

Let Claude Code, Cursor, or OpenCode autonomously prepare, validate, and submit your showcase via Model Context Protocol.

AI Agent Setup

Eligibility & Access

Who can submit to Build with AK?

Existing AgentKit Customers

If you own an active license (Engineer Kit, Marketing Kit, Combo, Desktop App) or an active team seat, submission is 100% free and unlocked automatically on your dashboard.

Early Bird Paid Access

Not an existing customer yet? You can secure directory access via our Early Bird offer at $49 (50% OFF, first 100 slots). Plus, 5 random early bird products will be selected and featured on the AgentKit homepage for 30 days.

Method 1: Self-Service Web Studio (Visual / No-Code)

Fastest way to build and preview directly in your browser.

Open the Studio

Fill in Product Identity & Upload Logo

Enter your product name, tagline, custom slug (e.g. /build-with-ak/my-app), website URL, demo URL, and upload your square logo directly to Cloudflare R2 storage.

Pick a Template or Compose Custom Blocks

Choose from 5 curated templates (SaaS Product Launch, Minimalist Showcase, DevTool & Open Source, Visual Media App, or Case Study), or drag and reorder 9 accessible block types on the interactive canvas.

Live Preview & Submit

Click Live Preview to test your draft across Desktop and 390px Mobile viewports. When satisfied, click Submit for Review. Your revision will be frozen for review with zero downtime for any existing live listing.

Method 2: AI-Powered Autonomous CLI Toolkits

Use our developer CLI package @agentkit/build-with-ak from the command line or CI scripts.

1. Install and Configure

Install globally or clone directly from the official open-source repository (bestagentkits/build-with-ak-toolkits):

Terminal Setup

# Option A: Global install via npm / pnpm / bun
npm install -g @agentkit/build-with-ak

# Option B: Clone & link from GitHub source
git clone https://github.com/bestagentkits/build-with-ak-toolkits.git
cd build-with-ak-toolkits && pnpm install && pnpm build && npm link

# Set your API Key (generate from /account/api-keys)
export AGENTKIT_API_KEY=ck_live_your_api_key_here
export AGENTKIT_ENV=production

Workspace Initialization

# Initialize a new workspace with SaaS template
build-with-ak init --template saas_product_launch --dir my-product-showcase
cd my-product-showcase

# Inspect the scaffolded build-with-ak.json and blocks.json
ls -la

3. Upload Media & Validate

Media & Validation

# Check if your preferred slug is available
build-with-ak slug check my-cool-app

# Upload your logo (must be PNG/JPG/WebP/SVG, max 5MB)
build-with-ak media upload ./assets/logo.png --kind logo --ref logo

# Run full strict readiness validation
build-with-ak validate --ready

4. Live Preview & Push

Preview & Submit

# Start local live-reload preview server on 127.0.0.1:4173
build-with-ak preview --watch

# Push draft with atomic CAS concurrency check
build-with-ak push --yes

# Submit draft for moderation review (freezes submittedRevisionId)
build-with-ak submit --yes

Method 3: Autonomous AI Agents via MCP

Empower Claude Code, Cursor, OpenCode, and Windsurf to create and submit your showcase autonomously.

Build with AK Model Context Protocol (MCP) Server Flow

Configure MCP Server (Claude Desktop, Cursor, OpenCode)

Add the following to your MCP configuration file (claude_desktop_config.json, .cursor/mcp.json, or opencode.json):

mcpServers config

{
  "mcpServers": {
    "build-with-ak": {
      "command": "build-with-ak-mcp",
      "env": {
        "AGENTKIT_API_KEY": "ck_live_your_api_key_here",
        "AGENTKIT_ENV": "production"
      }
    }
  }
}

Available MCP Tools

get_listing_status

Get current draft revision, published revision, and moderation status.

check_slug_availability

Check if a slug is available and receive alternative recommendations.

list_templates & inspect_template

Explore all 5 pre-configured layout blueprints and block schemas.

upload_media

Upload and finalize logos or screenshots to Cloudflare R2 object storage.

validate_listing & push_draft

Validate structure and perform atomic CAS update to save draft.

submit_for_review

Freeze submitted revision and request moderation review.

Example Agent Prompt

"Read our project's README.md and logo in ./assets/logo.png. Use the build-with-ak MCP tools to scaffold a showcase with the saas_product_launch template, upload the logo, validate the blocks, and submit our product to the Build with AK directory."

Method 4: Direct REST API

Integrate directly from custom scripts or backends using standard HTTP requests.

Method	Endpoint	Description
GET	/api/build-with-ak/listing	Fetch active draft and published listing revisions
PUT	/api/build-with-ak/listing	Save draft blocks with CAS expectedDraftRevisionId check
POST	/api/build-with-ak/listing/submit	Freeze revision and submit for review
GET	/api/build-with-ak/slug-availability	Query slug availability and recommendations
POST	/api/build-with-ak/media/upload-intent	Request R2 presigned upload URL
POST	/api/build-with-ak/media/finalize	Verify uploaded asset in R2 and mint asset ID

Sample cURL Request

cURL Request Example

curl -X PUT "https://agentkit.best/api/build-with-ak/listing" \
  -H "Authorization: Bearer ck_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "expectedDraftRevisionId": "3a2b1c0d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "name": "My AI Product",
    "slug": "my-ai-product",
    "tagline": "The fastest AI coding companion",
    "category": "developer_tools",
    "blocks": [ ... ]
  }'

Open Source & Toolkits

Explore the Toolkits Repository & Packages

The Build with AK CLI and MCP server are fully open source. Check out the source code, read detailed contract documentation, or report issues on GitHub:

build-with-ak-toolkits

github.com/bestagentkits

@agentkit/build-with-ak

npmjs.com package

Ready to submit your showcase?

Explore existing products or launch the submission studio now.

Browse Directory Launch Studio →