Private alpha

API and MCP

Uploads are public-unlisted by default. Every upload must include Upload Certification.

Raw HTML Upload

POST /api/decks
Content-Type: application/json

{
  "html": "<!doctype html>...",
  "title": "Optional",
  "certifyRights": true
}

URL Upload

POST /api/decks
Content-Type: application/json

{
  "sourceUrl": "https://example.com/deck.html",
  "certifyRights": true
}

CLI

tada upload ./deck.html --api-url http://localhost:4180
tada upload https://example.com/deck.html --api-url http://localhost:4180 --json

MCP

Hosted endpoint for this prototype:

http://localhost:4180/mcp

Tools:

upload_html_deck: raw HTML, optional title, certifyRights: true
upload_html_file: MCP-provided file content, filename, optional title, certifyRights: true
upload_html_url: public source URL, optional title, certifyRights: true

Response Shape

{
  "id": "abc123",
  "viewUrl": "http://localhost:4180/d/abc123",
  "visibility": "unlisted",
  "manageable": false,
  "thumbnailStatus": "pending",
  "warnings": [],
  "notices": []
}