# Upesi

Upesi is a minimalist hosting service for static mini-apps at https://www.upesi.dev.

Core workflow:
- Install CLI: curl -sSf https://api.upesi.dev/install.sh | bash
- Authenticate: upesi login
- Create an app: upesi create <subdomain>
- Upload files: upesi sync .
- Open app: upesi open

Agent-facing resources:
- MCP endpoint: https://api.upesi.dev/mcp
- OAuth protected resource metadata: https://api.upesi.dev/.well-known/oauth-protected-resource
- OAuth authorization server metadata: https://api.upesi.dev/.well-known/oauth-authorization-server
- Agent manifest: https://api.upesi.dev/.well-known/agent.json
- OpenAPI description: https://api.upesi.dev/openapi.json
- Skill guide: https://api.upesi.dev/SKILL.md

Capabilities:
- Static file hosting on https://<subdomain>.upesi.dev
- Optional SPA fallback per app
- Password-protected apps
- Custom domains with DNS status checks
- App-scoped environment variables for server-side proxy headers
- App-specific same-origin proxy routes managed by API, CLI, and MCP
- Built-in same-origin document database via /_db/db.js
- MCP tools for apps, files, domains, variables, protection, SPA mode, and UpesiDB