# deplo.sh

> Publish HTML files, static sites, and JSON APIs to a live public URL in a single API call. No Git. No config. Built for AI agents and developers.

## What is deplo.sh?

deplo.sh is a deployment platform designed for AI agents and automated workflows. It lets you deploy static files, HTML sites, and JSON data to a live URL — no Git repo, no build step, no config files. One API call → one URL.

## Who is it for?

- AI agents (LangChain, CrewAI, custom agents) that need to publish output
- AI coding assistants (Claude, Cursor, Windsurf) via MCP
- CI/CD pipelines that publish artifacts
- Developers who want instant deployment without infrastructure

## Integration methods

### MCP Server (for Claude, Cursor, and MCP-compatible hosts)
- URL: https://mcp.deplo.sh
- Protocol: Model Context Protocol (MCP)
- Auth: DEPLO_KEY environment variable
- Tools: deploy, list_projects, get_project, list_deployments, promote_deployment, delete_project
- Docs: https://deplo.sh/docs/integrations/mcp

### TypeScript SDK
- Package: @deplo/sdk (npm)
- Install: npm install @deplo/sdk
- Docs: https://deplo.sh/docs/integrations/sdk

### CLI
- Package: @deplo/cli (npm)
- Install: npm install -g @deplo/cli
- Usage: deplo deploy ./file.html --project my-project
- Docs: https://deplo.sh/docs/integrations/cli

### REST API
- Base URL: https://api.deplo.sh
- Auth: Bearer token (sk_live_xxx)
- Deploy: POST /v1/deployments
- Docs: https://deplo.sh/docs/integrations/rest-api

## Key concepts

- **Project**: A named container for deployments. Each project gets a subdomain (project-slug.deplo.sh).
- **Deployment**: A versioned snapshot of files. Projects can have multiple deployment versions.
- **TTL**: Time-to-live for ephemeral deployments. Set to "forever" for permanent hosting.
- **Deployment types**: static_file (single file), static_site (directory with index.html), json_api (JSON data served as API).

## Documentation

- Overview: https://deplo.sh/docs/introduction/overview
- Quickstart: https://deplo.sh/docs/getting-started/quickstart
- Authentication: https://deplo.sh/docs/getting-started/authentication
- Concepts: https://deplo.sh/docs/introduction/concepts
- Projects: https://deplo.sh/docs/platform/projects
- Custom Domains: https://deplo.sh/docs/platform/custom-domains
- Billing: https://deplo.sh/docs/platform/billing