Developers

Publish from wherever you build

One API key, three ways in. Create a key on your dashboard, then use it from the CLI, from an AI coding tool through the MCP server, or straight against the HTTP API.

Claude Code, Cursor, and other MCP clients

Add the AppShelf MCP server once, then say “publish this to AppShelf” inside your editor. The server exposes publish, update, list, and stats tools.

# Claude Code
claude mcp add appshelf --env APPSHELF_API_KEY=as_live_... -- npx -y appshelf-mcp

# Cursor, Windsurf, or any MCP client: add to your MCP config
{
  "mcpServers": {
    "appshelf": { "command": "npx", "args": ["-y", "appshelf-mcp"], "env": { "APPSHELF_API_KEY": "as_live_..." } }
  }
}

Packages: appshelf (CLI) and appshelf-mcp (MCP server) on npm.

Command line

export APPSHELF_API_KEY=as_live_...
npx appshelf whoami
npx appshelf publish --kind tool --title "My App" --url https://myapp.com --category productivity --builder lovable
npx appshelf publish --kind game --title "My Game" --build ./dist --category arcade --builder claude-code
npx appshelf list
npx appshelf stats my-app

HTTP API

Base URL https://appshelf.io/api/v1. Send your key as Authorization: Bearer as_live_…. JSON in, JSON out.

Method	Path	What it does
GET	/me	Who the key belongs to.
GET	/apps	Your listings.
POST	/apps	Publish a listing. Live immediately.
GET	/apps/{id\|slug}	One listing.
PATCH	/apps/{id\|slug}	Update any fields.
DELETE	/apps/{id\|slug}	Take it off the shelf.
GET	/apps/{id\|slug}/stats?days=30	Daily views and plays.
POST	/uploads	Signed upload URLs for a hosted game build.

Publish a tool

curl -X POST https://appshelf.io/api/v1/apps \
  -H "Authorization: Bearer $APPSHELF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "tool",
    "title": "Budget Buddy",
    "tagline": "Track spending in one screen.",
    "description": "A simple budget tracker for people who hate spreadsheets.",
    "url": "https://budgetbuddy.app",
    "builder_tool": "lovable",
    "category": "finance",
    "tags": ["budget", "personal finance"]
  }'

Fields

kind: game or tool. Games need url or build_key; tools need url.
builder_tool: lovable, bolt, replit, base44, v0, claude-code, cursor, codex, rosebud, rork, emergent, google-ai-studio, other.
category for games: arcade, puzzle, action, strategy, casual, idle, multiplayer, word, simulation, other-game.
category for tools: productivity, developer, design, writing, finance, education, health, marketing, utilities, fun, other-tool.
pricing: free, pwyw, or paid with price in USD.
tags: up to 8 short strings. cover_url: an https image, 16:9 works best.

After publishing, AppShelf writes the How-to and FAQ sections for the page and pings search engines in the background. Edit anything later with PATCH or from your dashboard.