highreel
Developers

Your AI assistant, connected to Highreel

Highreel runs an MCP server. Connect the assistant you use and ask about your Highreels in your own words, with the same numbers as Analytics; while it works on your site it can also list your published Highreels, fetch a person's link to test with, read these docs and check that the banner is live.

7 min read

What it does

An assistant connected to Highreel reads the account it's connected to, nothing else, and changes nothing: it can't edit a sheet, publish, send, or make or revoke keys. Ask it "Is Highreel on my site yet?" and it checks; ask it to set Highreel up and it looks at your code, picks the lines for what your site is built with, and makes the change.

Ask it about your Highreels and it answers from the numbers your home, Analytics, Activity and Share show, counted the same way: Highreel does the counting, the assistant the reading and comparing.

  • "How many people opened their Highreel in the last 7 days?"
  • "Which slide do people stop watching on?"
  • "Did any of our emails bounce, and why?"
  • "Who hasn't opened theirs yet?"
  • "Which of our Highreels did best this year?"
  • "How many people saw theirs on our website?"

The server is at https://highreel.app/mcp: Streamable HTTP, stateless, tools and one prompt. Assistants sign in with Highreel (OAuth 2.1, the MCP's own way), or send an API key.

ChatGPT

  1. Open Plugins

    In ChatGPT, go to Plugins (chatgpt.com/plugins), select the plus button, then "Add custom MCP server".

  2. Add Highreel

    Name it Highreel and paste this address under Connection. Choose OAuth for authentication, confirm the warning ("I understand and want to continue") and select "Create as a plugin". The address: https://highreel.app/mcp

  3. Sign in

    Your browser opens Highreel: sign in if you aren't already, check what it can read, and tap Allow.

  4. Ask it

    Start a new chat, type @ and pick Highreel, then ask "How many people opened their Highreel in the last 7 days?".

Claude

In Claude on the web or the desktop app. On a Team or Enterprise plan, an owner adds it for everyone under Organization settings › Connectors.

  1. Add a custom connector

    In Claude, go to Customize › Connectors, click "+ Add", then "Add custom connector".

  2. Add Highreel

    Name it Highreel, paste this address and click Continue. Under Authentication choose "Sign in now", under OAuth client "Register automatically", then click Add. The address: https://highreel.app/mcp

  3. Sign in

    Your browser opens Highreel: sign in if you aren't already, check what it can read, and tap Allow.

  4. Ask it

    In a chat, click + at the lower left, then Connectors, and turn Highreel on. Then ask "How many people opened their Highreel in the last 7 days?".

Claude also offers "Use Claude's published identity" as its OAuth client; "Register automatically" is the one Highreel supports today.

Claude Code

Add Highreel in your site's folder:

Terminal
claude mcp add --transport http highreel https://highreel.app/mcp

Then start claude, type /mcp and pick highreel to sign in. Your browser opens Highreel: sign in, check what it can read, and tap Allow. Ask it "Is Highreel on my site yet?". The prompt set_up_highreel starts the whole job: type /mcp__highreel__set_up_highreel, or add the platform after it (/mcp__highreel__set_up_highreel nuxt).

Cursor

Add Highreel to ~/.cursor/mcp.json (or the project's .cursor/mcp.json), keeping any servers already there. Cursor asks you to sign in to Highreel the first time.

~/.cursor/mcp.json
{
  "mcpServers": {
    "highreel": {
      "url": "https://highreel.app/mcp"
    }
  }
}

VS Code

Copilot in VS Code reads the same kind of file from ~/.copilot/mcp-config.json. When it offers it, choose Authenticate in Highreel's server actions to sign in.

~/.copilot/mcp-config.json
{
  "mcpServers": {
    "highreel": {
      "type": "http",
      "url": "https://highreel.app/mcp"
    }
  }
}

Anything else

Any assistant that connects to a remote MCP server over HTTP works. Without a credential the server answers 401 with WWW-Authenticate naming its protected resource document (https://highreel.app/.well-known/oauth-protected-resource/mcp), which names the authorization server: assistants register themselves (dynamic client registration), sign in with PKCE (S256) and ask for the /mcp resource. Access tokens last 60 minutes; refresh tokens 30 days from their last use, and they change on every use.

With a key

For a computer without a browser (a server, a CI job), use a key instead of signing in. In Highreel, open Integrations, then the AI assistants tab, choose "No browser on that computer? Use a key instead", and make one. It's shown once. An assistant key is apart from the website keys your site's server uses, so a key you gave your developer never reads more because you connected an assistant.

Terminal
claude mcp add --transport http highreel https://highreel.app/mcp --header "Authorization: Bearer YOUR_ASSISTANT_KEY"

In a settings file, keep the key in your environment (export HIGHREEL_ASSISTANT_KEY=YOUR_ASSISTANT_KEY) and let the file read it:

~/.cursor/mcp.json
{
  "mcpServers": {
    "highreel": {
      "url": "https://highreel.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:HIGHREEL_ASSISTANT_KEY}"
      }
    }
  }
}

Every request then carries Authorization: Bearer with the key. An account has up to 10 keys at once, website and assistant keys together; each key or sign-in gets 120 requests a minute, and one made for one business reads only that business's Highreels.

The tools

ToolWhat it gives back
list_highreelsYour published Highreels: id, name, business, year, people with a link, when published, and its page in Highreel.
get_linksA page of a Highreel's people with each one's link, 20 at a time (up to 50).
find_personOne person's link, by their sheet id or email (up to 10 matches).
setup_guideFor a platform (HTML, React, Vue, Next.js, Nuxt, a native app, Shopify, WordPress): the lines, where each link comes from, the docs' code, your Highreels' ids and how to check.
read_docsA developer page as Markdown: quick start, banner, player, API, frameworks, Shopify, WordPress, AI assistants.
check_setupWhether it's live on your site: opens there per Highreel, when each website key last fetched links, and the next step.
overviewEvery Highreel of a year, drafts too: status, people with a link, emailed, opened, and the years there are.
analyticsAnalytics for a period, all Highreels or one: who opened, watched to the end, saved, shared, tapped; opens a day; how, where and on what; each slide.
peopleA page of a Highreel's people (up to 50) and what each did: who opened, who didn't, how far, saves, shares, taps.
personOne person's visits by their sheet id: when, how and on what they opened, how far they got, what they did.
activityThe newest visits, 50 at a time: who, which Highreel, when, how far, what they did.
sendingShare's numbers for a Highreel: emailed, failed and why, bounced, unsubscribed, the newest send, WhatsApp, newsletter pushes, opens on your site.
sheet_numbersThe sheet summed per column: count, sum, smallest, median, largest; a text column's commonest values.

People come 20 at a time from get_links (up to 50, with next for the page after) and up to 10 from find_person, with exactly the fields the API gives: a site's real import still goes through the API, from its server, with a website key.

The tools from overview on answer questions, for an assistant that signed in or an assistant key only: a website key gets the setup tools alone, so a key you gave your site's developer never reads how your customers engaged. Their periods are Analytics' (last 7 days, last 30 days, last 90 days, last 12 months), ending today in the time zone the assistant names; lists come up to 50 at a time, and sums are done by Highreel, so a question about thousands of people doesn't page through them all. A person who opened is someone with at least one visit; your own opens while signed in, test emails and bots aren't counted.

Keys stay where they belong

  • The assistant's key is for the assistant. When it adds Highreel to a site that needs a key (WordPress, or your own server fetching links), the site gets its own website key, which you make on Integrations and it reads from HIGHREEL_API_KEY in the server's environment.
  • No tool makes, shows or revokes a key: Highreel keeps only a fingerprint of each.
  • A person's link opens their Highreel, so the assistant uses one only in a test page and never commits it.

What it reads, and who sees it

An assistant sees what the account's owner sees in Highreel, never more: its Highreels (drafts too) and how each is doing; each person's first name, the id from the sheet and what they did; how sending went, with the mail servers' reasons and the addresses taken out; and the sheet's columns added up, never one person's own cells. For setting up a site, it also reads each person's email and link. Never a phone number. What it reads goes to the company that runs the assistant, under your own agreement with them, like a spreadsheet pasted into a chat.

Every request counts against the key's 120 a minute, shared with the API. Calls are logged by tool name, time and how many rows they returned, never their arguments.

Help

Something not working, or a question about connecting an assistant? Write to hello@highreel.app with the assistant you use and what you asked it, and we'll help. Signed in to Highreel, you can also use Feedback at the foot of the sidebar.

Questions

Can I use it with ChatGPT or Claude in the browser?

Yes. Add Highreel as a custom connector with the address above, sign in to Highreel and allow it, then ask in any chat.

Can the assistant send or publish for me?

No. It only reads. When you ask for something that changes your Highreels, like sending everyone a reminder, it gives you the page in Highreel where you do it.

Are its numbers the same as my dashboard's?

Yes. It reads the same counts Analytics, Activity and Share show, for the same periods. It can't split a period it wasn't given (the last 30 days against the 30 before), so it asks for the longer one and subtracts, or says so.

How do I disconnect an assistant?

On Integrations, AI assistants tab, under Connected: Disconnect it, or revoke its key. It stops at once, from its next request.

Keep reading

Your customers had a great year. Show them.

No account needed · from $99 per campaign