slideless-mcp
MCP server for Slideless. Wraps the Slideless HTTP API as Model Context Protocol tools so users can list, share, upload, and manage HTML presentations from any MCP host (Claude Desktop, claude.ai, ChatGPT desktop, Cursor, etc.) without installing the slideless CLI.
Architecture
Stateless Cloudflare Worker (Durable Object per session for MCP state). The Worker forwards the user's Authorization: Bearer cko_… header to the Slideless Cloud Functions in europe-west1. No database, no secrets to rotate — the user's API key never leaves the connector header.
Claude / ChatGPT → mcp.slideless.ai/mcp (Cloudflare Worker)
│
▼
europe-west1-slideless-ai.cloudfunctions.net
Use as a connector
- Sign in at https://app.slideless.ai → Settings → API Keys → Create
- Copy the
cko_…key (shown once) - In Claude Desktop: Settings → Connectors → Add custom connector
- URL:
https://mcp.slideless.ai/mcp - Header:
Authorization: Bearer cko_…
- URL:
- Connect. The server validates the key on connect; bad keys fail fast.
Tools
| Tool | What it does |
|---|---|
slideless_whoami | Identity check — returns org, key name, scopes |
slideless_list_presentations | List owned + invited presentations |
slideless_get_presentation | Full info for one presentation (tokens, collaborators) |
slideless_list_versions | Version history of a presentation |
slideless_get_version | Manifest of a specific version |
slideless_download_version | Manifest + inline text-file contents (HTML/CSS/JS up to 256 KB each) |
slideless_upload_html_presentation | Upload a single-file HTML deck |
slideless_upload_presentation_files | Upload a multi-file deck (base64 array) |
slideless_add_share_token | Mint a public viewer URL |
slideless_set_token_version_mode | Pin or unpin a token to a version |
slideless_unshare_presentation | Revoke one or all share tokens |
slideless_share_via_email | Send the share URL by email |
slideless_invite_collaborator | Grant another user dev access (sends email) |
slideless_uninvite_collaborator | Revoke a collaborator |
slideless_list_collaborators | List collaborators on a presentation |
slideless_delete_presentation | Permanently delete a presentation |
Local development
npm install
npm run dev # wrangler dev → http://localhost:8787
Test with the MCP Inspector:
npx @modelcontextprotocol/inspector
# Set transport: HTTP (streamable)
# URL: http://localhost:8787/mcp
# Header: Authorization: Bearer cko_<your-key>
Deploy
npm run deploy
The first deploy creates the Worker at https://slideless-mcp.<account>.workers.dev/mcp. Bind the custom domain mcp.slideless.ai via Cloudflare dashboard or wrangler deploy --routes once DNS is in place.
Type checking:
npm run typecheck
Source layout
src/
├── index.ts # Worker entry: routing, rate limiting, McpAgent
├── server.ts # Tool registration entry point
├── slidelessClient.ts # Typed fetch wrapper around Cloud Functions
├── types.ts # Wire shapes (mirrors slideless-app types/)
├── errors.ts # SlidelessApiError + wrapToolErrors helper
└── tools/
├── identity.ts # slideless_whoami
├── presentations.ts # list / get / versions / download / delete
├── upload.ts # upload_html / upload_files (3-step orchestration)
├── sharing.ts # tokens, version mode, unshare, email
└── collaborators.ts # invite / uninvite / list
Related repos
slideless-app— backend Cloud Functions this server proxiesslideless-cli— npm CLI that uses the same APIslideless-plugin— Claude Code plugin (companion authoring + upload skills)