Upesi

Upesi Plugin for Claude Code

Deploy and manage static web apps on Upesi directly from Claude Code.

Install

Via Marketplace (Claude Code CLI)

/plugin marketplace add oona-ai/upesi-dev-plugin
/plugin install upesi@upesi-marketplace

Via Connector (Claude Desktop)

Settings > Connectors > https://api.upesi.dev/mcp

Direct Plugin (Claude Code CLI)

claude --plugin-dir /path/to/upesi-dev-plugin

What's Included

• MCP Server (34 tools) — app management, file operations, databases, custom domains, variables, proxy routes
• Skill — deployment workflow guide with all tool parameters
• Commands — /upesi:deploy, /upesi:status
• Agent — web-deployer for automated deployments
• Script — scripts/encode.py for batch base64 file encoding

MCP Tools

Tool	Description
upesi_whoami	Show current user info
upesi_apps_list	List all apps
upesi_app_create	Create a new app
upesi_app_info	Get app details
upesi_app_destroy	Delete an app
upesi_files_list	List files in an app
upesi_files_upload	Upload files (base64)
upesi_files_download	Download a file
upesi_files_delete	Delete a file
upesi_custom_domains_list	List custom domains
upesi_custom_domains_add	Add a custom domain
upesi_custom_domains_remove	Remove a custom domain
upesi_variables_list	List app environment variables (values hidden)
upesi_variable_set	Set or update an app environment variable
upesi_variable_remove	Remove an app environment variable
upesi_proxy_routes_list	List app-specific proxy routes
upesi_proxy_route_set	Set or update an app-specific proxy route
upesi_proxy_route_remove	Remove an app-specific proxy route
upesi_db_status	Show database status
upesi_db_reset	Reset database
upesi_db_key	Show API key
upesi_db_key_rotate	Rotate API key
upesi_db_find	Query database documents
upesi_db_get	Read one database document
upesi_db_insert	Create one database document
upesi_db_update	Merge fields into a document
upesi_db_replace	Replace all user fields on a document
upesi_db_delete	Delete one database document
upesi_db_count	Count matching database documents
upesi_skill	Get the complete deployment guide

Authentication

OAuth 2.0 with PKCE. When connecting via Claude Desktop or Claude Code, authentication is handled automatically.

CLI projects can keep declarative proxy routes in .upesi/proxy.json in the app project directory and apply them with upesi proxy routes apply. The file is local config, not a hosted asset.