FreeAppStore MCP Server
Remote MCP server for AI agents to interact with the FreeAppStore platform.
Endpoint: https://mcp.freeappstore.online/mcp
Connect
Claude Code
claude mcp add freeappstore -- npx mcp-remote https://mcp.freeappstore.online/mcp
Codex
codex mcp add freeappstore --url https://mcp.freeappstore.online/mcp
Cursor
Settings > MCP > Add Server: npx mcp-remote https://mcp.freeappstore.online/mcp
Project-local .mcp.json
{
"mcpServers": {
"freeappstore": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.freeappstore.online/mcp"]
}
}
}
Any MCP client
Streamable HTTP transport at https://mcp.freeappstore.online/mcp
Tools
Build (write code yourself)
| Tool | Auth | Description |
|---|---|---|
create_app | FAS token | Provision repo + hosting + listing, scaffold template, deploy live |
update_files | Owner | Write/overwrite files in your app's repo; auto-redeploys |
Build (let the VibeCode agent write code)
| Tool | Auth | Description |
|---|---|---|
agent_build | FAS token + vaulted AI key | Hand a prompt to the VibeCode agent; it writes + deploys |
agent_status | FAS token | Poll an agent_build session for progress + live URL |
Read
| Tool | Auth | Description |
|---|---|---|
list_files | None | List files in an app's repo |
read_file | None | Read a file from an app's repo |
Inspect
| Tool | Auth | Description |
|---|---|---|
list_apps | FAS token | List your published apps |
app_info | None | Live URL, repo, store listing, up/down status |
deploy_status | None | Check last 5 GitHub Actions runs for any app |
app_logs | Owner | Recent errors/warnings/SDK calls/build info |
platform_guide | None | Fetch full SKILLS.md (the complete platform guide) |
sdk_reference | None | SDK docs for auth, KV, counters, collections, rooms, proxy, keys, UI |
Discovery
- MCP Registry:
io.github.freeappstore-online/mcp - Auto-discovery:
freeappstore.online/.well-known/mcp.json - Platform guide:
freeappstore.online/llms.txt - Docs:
freeappstore.online/docs/mcp
Architecture
Cloudflare Worker with a SQLite-backed Durable Object (FasMcpAgent), using the agents SDK. Deployed via GitHub Actions.
Development
npm install
npm run dev # local dev server
npm run deploy # deploy to CF Workers
License
MIT.