mcp

Publish an HTML or Markdown document as a hosted page on htmldrop. Returns the public share URL. Use this whenever a user asks to publish, share, or 'put on the web' some HTML / Markdown content. Pass exactly one of `html` or `markdown`.

{
  "type": "object",
  "properties": {
    "html": {
      "type": "string",
      "description": "Raw HTML document content. Either this or `markdown` must be set."
    },
    "markdown": {
      "type": "string",
      "description": "Markdown content. Will be rendered to HTML on the server. Either this or `html` must be set."
    },
    "slug": {
      "type": "string",
      "description": "Optional URL slug (3-63 chars, lowercase letters, numbers, hyphens). If omitted, a random slug is assigned."
    },
    "title": {
      "type": "string",
      "description": "Optional title shown in the dashboard list."
    }
  }
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Public share URL of the published page."
    },
    "id": {
      "type": "string",
      "description": "Opaque site id. Pass to htmldrop_delete to remove later."
    },
    "slug": {
      "type": "string",
      "description": "Resolved slug for the published site."
    }
  },
  "required": [
    "url",
    "id",
    "slug"
  ]
}

List every site the authenticated tenant has published. Returns each site's slug, id, and public URL.

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "sites": {
      "type": "array",
      "description": "Every published site for the authenticated tenant.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "slug",
          "url"
        ]
      }
    }
  },
  "required": [
    "sites"
  ]
}

Delete a site by its id. The id is the opaque string returned from htmldrop_list (NOT the slug). Once deleted the public URL returns 404 immediately.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The site's id, as returned by htmldrop_list."
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The deleted site's id."
    },
    "deleted": {
      "type": "boolean",
      "description": "Always true on success."
    }
  },
  "required": [
    "id",
    "deleted"
  ]
}