Skip to main content
Glama
README.md
<img src="assets/logo.png" alt="" width="64" height="64">

# Sparkler for your agent

[Sparkler](https://withsparkler.com) makes presentation decks that the audience joins from their phones. You make the deck by asking the agent you already use: Claude, ChatGPT, Cursor, Claude Code, Codex or any other app that speaks MCP. Sparkler has no AI of its own. Your agent writes the slides; Sparkler checks them, renders them in one of its themes, hosts the talk on one link, runs the live room and sends the follow-up email afterwards.

This repository holds Sparkler's listing and plugin files. Sparkler itself is a hosted service at `https://withsparkler.com/mcp`, so there is nothing here to install or run.

## Connect

The address is the same everywhere:

```
https://withsparkler.com/mcp
```

It is a remote MCP server (Streamable HTTP) with OAuth sign-in. The first time, your agent opens a Sparkler page in the browser; you sign in with your email address and choose Allow. A new email address gets a free account.

**Claude:** find Sparkler in Claude's connector directory and choose Connect, or add a custom connector with the address above (Settings, Connectors, Add custom connector).

**ChatGPT:** find Sparkler in ChatGPT's apps and choose Connect.

**Cursor:** install Sparkler from the Cursor Marketplace, or add this to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "sparkler": { "url": "https://withsparkler.com/mcp" }
  }
}
```

**VS Code:**

```sh
code --add-mcp '{"name":"sparkler","type":"http","url":"https://withsparkler.com/mcp"}'
```

**Claude Code:**

```sh
claude mcp add --transport http sparkler https://withsparkler.com/mcp
```

Then type `/mcp`, choose sparkler, and sign in.

**Codex:**

```sh
codex mcp add sparkler --url https://withsparkler.com/mcp
codex mcp login sparkler
```

**Anything else:** any MCP client that supports remote servers with OAuth works with the address above. For a client without browser sign-in, make a personal key on the [Connect page](https://withsparkler.com/app/connect) and send it as `Authorization: Bearer <key>`.

## What to ask for

- "Use Sparkler to make a 20-minute talk on onboarding new managers, for about 40 team leads. Open with a question for the room to guess, add a vote and a question time, and send me the preview link."
- "Bring my PowerPoint into Sparkler and add three questions for the audience."
- "Make this deck in our brand colours from example.com, then publish it and give me the present link."
- "How did yesterday's talk go? Show me the votes and the questions people asked."

## The tools

"Changes things" means the tool saves, replaces or removes something in your Sparkler account; your agent app may ask you before it runs one of them.

| Tool | What it does | Changes things |
|---|---|---|
| `get_guide` | The guide to slide types, themes and audience features | No |
| `whoami` | Which Sparkler account is connected, and its plan | No |
| `create_deck` | Makes a new deck and returns a private preview link | Adds a deck |
| `get_deck` | Lists your decks, or reads one | No |
| `edit_deck` | Changes a deck: adds, replaces, moves or deletes slides, sets the theme | Yes, can remove slides |
| `add_image` | Stores an image for slides, sent by your agent or fetched from a public link | Adds an image |
| `preview` | Pictures of slides, so your agent can check how they look | No |
| `preview_sheet` | The whole deck on one contact sheet | No |
| `upload_theme` | Saves your own theme, or makes one from a brand's website | Yes, can replace or remove a theme |
| `start_import` | Starts bringing in a PowerPoint file or a Google Slides link | Adds an import |
| `get_import` | Reads an import's slides, text and pictures, for your agent to rebuild | No |
| `publish` | Publishes a deck and returns its share link, present link and join code; can also take it down | Yes, makes a deck public or private |
| `get_results` | The room's answers, questions and follow-up figures after a talk | No |

A deck stays private until your agent publishes it. Audience answers are anonymous to the speaker.

## In this repository

- `server.json`: the entry in the [official MCP Registry](https://registry.modelcontextprotocol.io) (`com.withsparkler/sparkler`)
- `.cursor-plugin/plugin.json` and `mcp.json`: the Cursor plugin
- `assets/logo.png`: the icon

## Links

- Documentation: https://withsparkler.com/docs
- Privacy: https://withsparkler.com/privacy
- Terms: https://withsparkler.com/terms
- Help: hello@withsparkler.com (a person reads every email)

The files in this repository are under the MIT licence. Sparkler is made by Incremento Ltd.