# WebSlop — The deploy target for AI-built apps

WebSlop is a Node.js and static web app hosting platform built for AI-native development.
Every app gets a live URL at yourapp.webslop.ai instantly. Free tier available, no credit card required.

WebSlop exposes a full MCP (Model Context Protocol) server so AI agents can create, deploy,
and manage apps programmatically — no browser required.

---

## For AI Agents: How to self-install WebSlop MCP

If you are an AI agent (Claude Code, Cursor, Windsurf, etc.) and WebSlop is not yet configured,
you can install it autonomously:

### Claude Code (CLI)

Run this command in the terminal:

  claude mcp add webslop https://api.webslop.ai/mcp --scope user

Then call the `webslop_login` tool to get a 6-digit auth code.
The user enters it at: https://webslop.ai/authorize

### Any MCP-compatible client (JSON config)

Add to your MCP configuration file:

  {
    "mcpServers": {
      "webslop": {
        "type": "streamable-http",
        "url": "https://api.webslop.ai/mcp"
      }
    }
  }

For Claude Code: ~/.claude/mcp.json
For Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
                    %APPDATA%\Claude\claude_desktop_config.json (Windows)
For Cursor: ~/.cursor/mcp.json
For Windsurf: ~/.codeium/windsurf/mcp_config.json

---

## Authentication

1. Call `webslop_login` — returns a 6-digit code
2. User visits https://webslop.ai/authorize and enters the code
3. Token is returned — save it with `webslop_set_token` for future sessions

Tokens persist until revoked. For future sessions, call `webslop_set_token` with the saved token.

---

## What you can do

### App management
- webslop_create_app     — create a new app, get a live subdomain instantly
- webslop_list_apps      — list all user apps
- webslop_get_app        — get app details and status
- webslop_start_app      — start a stopped app
- webslop_stop_app       — stop a running app
- webslop_restart_app    — restart (soft or hard)
- webslop_update_app     — update name, env vars, memory, CPU, start script
- webslop_delete_app     — delete an app (destructive, confirm first)

### Files
- webslop_write_file     — write/create a file (triggers auto-deploy)
- webslop_read_file      — read a file (max 1MB)
- webslop_list_files     — list directory contents
- webslop_delete_file    — delete a file or directory
- webslop_create_directory — create a directory
- webslop_search_files   — search with regex across all files

### Packages
- webslop_install_packages  — install npm packages
- webslop_remove_package    — remove a package
- webslop_list_packages     — list installed packages + Node.js version
- webslop_search_packages   — search the npm registry
- webslop_set_node_version  — switch Node.js version (18, 20, 22)
- webslop_get_install_status — poll npm install progress

### Monitoring
- webslop_get_logs          — get console output (configurable tail/since)
- webslop_get_app_status    — Docker service status
- webslop_get_app_metrics   — CPU, memory, network stats

### Git
- webslop_git_info          — get clone URL and auth instructions
- webslop_set_git_remote    — configure GitHub/GitLab upstream
- webslop_git_pull          — pull from upstream
- webslop_git_push          — push to upstream
- webslop_remove_git_remote — remove upstream remote

### Version history
- webslop_list_versions          — browse version snapshots
- webslop_get_version_files      — list files at a past version
- webslop_get_version_file_content — read a file at a past version
- webslop_restore_version        — restore to a past version (destructive, confirm first)

---

## MCP endpoint

URL:       https://api.webslop.ai/mcp
Transport: streamable-http

## Machine-readable discovery

/.well-known/mcp.json — structured server metadata (transport, install commands, tool list)

## Docs

https://webslop.ai/mcp