Build Your Store with an AI Assistant

Connect Biokit to Claude, Codex, Antigravity, or any MCP client and have it add products, upload images, and seed entire catalogs for you. No copy-pasting, no manual forms.

What you'll be able to say

"Add 8 products to MyStore — here's the CSV and the image folder." "Upload these 3 presets at $19, category 'presets'." "List my Biokit stores."

The assistant uploads images directly to Biokit storage (bytes never go through the chat) and creates products in bulk.

---

Before you start

1. A Biokit account with at least one store. (Sign up.)
2. A Biokit API key from Settings → API Key (shown only once — copy it).
3. An MCP-capable AI client: Claude Code, Claude Desktop, Codex CLI, Antigravity, or any other.

---

Step 1 — Install the Biokit MCP + Skill

The Skill (github.com/kernelventures/biokit-skills) teaches your AI the right way to upload product images — using pre-signed URLs so big files don't get stuffed into the chat.

The easy way

In your terminal:

npx skills add https://github.com/kernelventures/biokit-skills

Then ask your assistant to add the MCP:

Replace PASTE_YOUR_KEY_HERE with your API key before sending.

Verify

Ask: "List my Biokit stores." If your stores show up, you're connected.

---

Step 2 — Use it

One product:

"Add Brand Strategy Session to my consulting store — $350, digital, payment link stripe.com/p/session."

With a local image:

"Add Logo Pack for $49 — cover image ~/Desktop/logo-pack.png."

With a remote image:

"Add Sunset Preset for $24. Cover: https://i.imgur.com/abc123.jpg."

Whole catalog:

"Here's a CSV and an image folder. Add all 8 products to MyStore."

CSV format:

name,price,currency,description,category,paymentUrl,imageUrl,type
Turtle Bass Speaker,39.99,USD,Compact portable speaker,speakers,,turtle-bass.webp,physical
Turtle Echo Smart Speaker,79.99,USD,360° smart speaker,speakers,,turtle-echo.webp,physical

If imageUrl is a filename, the assistant looks for it next to the CSV. Up to 50 products per call.

---

Manual MCP config

Prefer to paste it yourself? Use the snippet for your client.

Claude Code / Claude Desktop — add to .mcp.json (Code) or Settings → Developer → Edit Config (Desktop):

{
  "mcpServers": {
    "biokit": {
      "type": "http",
      "url": "https://mcp.biokit.me/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Run /mcp in Code or restart Desktop.

Codex CLI — edit ~/.codex/config.toml:

[mcp_servers.biokit]
type = "http"
url = "https://mcp.biokit.me/mcp"
headers = { Authorization = "Bearer YOUR_API_KEY" }

Restart codex.

Antigravity — Project Settings → MCP Servers → Add Server:

• Name: biokit
• Transport: HTTP
• URL: https://mcp.biokit.me/mcp
• Header: Authorization: Bearer YOUR_API_KEY

---

Tips

• Name the store if you have several: "add to MyStore".
• Use WebP — 5–10× smaller than PNG, stays under the 5 MB limit.
• Review before creating: "Show me the plan first."
• Group with categories so customers can filter on your store page.

---

Troubleshooting

Problem	Fix
"Not authenticated"	Regenerate API key in Settings → API Key and update your config.
"Store not found"	Ask the assistant to list stores first, then use the right ID.
Tools don't appear	Reload MCP (/mcp in Claude Code, restart the app for Desktop/Codex/Antigravity).
"Unsupported image type"	Use PNG, JPEG, or WebP.
"Image too large"	Resize under 5 MB — convert to WebP.
storage.invalid_image_ref	Upload link expired (~75 min). Ask the assistant to retry.
Products missing in dashboard	Hard-refresh the page.

---

Going further

• For 50+ products, the CSV bulk import is even faster.
• Skills are open-source — browse, file issues, or contribute at github.com/kernelventures/biokit-skills.