Skip to main content

Uscreen MCP

Uscreen MCP connects your preferred AI agent directly to your Uscreen business

Uscreen MCP is a new way to interact with your business using AI. Instead of clicking through your admin panel, you'll be able to ask questions in plain language and get real answers backed by your actual store data.

What Is Uscreen MCP

MCP stands for Model Context Protocol, an open standard that lets AI agents communicate with external services. The Uscreen MCP connects your preferred AI client to your Uscreen business through a single, hosted endpoint.

Once authorized, your AI agent can pull information about your subscribers, analytics, and content catalog and, as MCP grows, take actions, all through natural conversation.

ℹ️ INFO: If you’re the Store Owner, you can authorize access directly. If you’re a team member, the Store Owner must grant you MCP permissions before you can connect an AI agent to store data.


Setup Instructions

Before you start, make sure your AI agent allows custom MCP connections. This may require a paid account. Free accounts may not allow you to add custom connectors.

Connecting Your AI Agent

📝 NOTE: The Uscreen MCP is available to stores with developer/API access and requires the New Website Editor. If you don’t see the card in Settings > Integration & Security, check that your account has the required access.

  1. Navigate to Settings > Integration & Security

  2. Find the Uscreen MCP card, marked with a Beta badge

  3. Copy the MCP URL https://app.uscreen.tv/mcp from the card

Follow Instructions for Specific Tools Below:

Claude Web & Desktop App

  1. Open Claude and go to Settings > Connectors

  2. Click Add Custom Connector

  3. Paste your Uscreen MCP URL: https://app.uscreen.tv/mcp

  4. Click Add

  5. Back on the Connectors screen, click Connect for the Uscreen connector, then approve access on the Uscreen authorization screen.

ChatGPT

ChatGPT requires Developer mode to add a custom MCP connection.

  1. Open ChatGPT (web or desktop), then go to Settings > Apps & Connectors

  2. Scroll to Advanced and toggle Developer mode on

  3. Return to Apps & Connectors and click Create

  4. Give it a Name (for example, Uscreen) and an optional description

  5. Set the connection type to the Server URL and enter https://app.uscreen.tv/mcp

  6. Set Authentication to OAuth

  7. Click Create, then approve access on the Uscreen authorization screen

ℹ️ INFO: ChatGPT recently renamed “Connectors” to “Apps.” Depending on your version, the menu may read Apps, Connectors, or Apps & Connectors, and the steps are the same.

Codex

  1. Open Codex and go to Settings > MCP Servers

  2. Add a new server and name it Uscreen MCP

  3. Select Streamable HTTP as the type

  4. Enter the URL https://app.uscreen.tv/mcp

  5. Leave the bearer token env var blank, leave headers blank, and leave headers from environment variables blank

  6. Click Save

  7. Back on the MCP server list, click Authenticate. A window opens in your browser. Approve access on the Uscreen authorization screen.

Cursor

  1. Open Cursor and go to Settings > Tools & MCPs.

  2. Click New MCP Server. This opens your mcp.json file.

  3. Add the Uscreen server to the file:

    {
    "mcpServers": {
    "uscreen": {
    "url": "https://app.uscreen.tv/mcp"
    }
    }
    }
  4. Save mcp.json Then fully quit and reopen Cursor so the server loads.

  5. Return to Settings > Tools & MCPs and complete the OAuth login when prompted to authorize access.

Other Tools

Uscreen MCP works with any AI client that supports custom MCP connectors.

The steps are always the same: add a custom MCP connector, paste https://app.uscreen.tv/mcp and log in through the OAuth authorization screen. For tools not listed above, please refer to their own MCP setup guides.


Permissions & Re-authorization

When you connect to Uscreen MCP, the authorization screen shows which permissions your AI agent can receive.

Store Owners can authorize available MCP permissions directly. Team members can only authorize permissions that the Store Owner has already granted to them in Uscreen.

When Uscreen adds new capabilities, like write actions, you may see a one-click re-authorize option in your AI agent. You’ll be notified when that happens and won’t need to reconnect from scratch.

📝 NOTE: If a Store Owner changes or revokes a team member’s MCP permissions, that team member may need to re-authorize their AI agent before continuing to use Uscreen MCP.

Managing MCP Permissions for Team Members

Store Owners can control which team members are allowed to connect the AI agent to Uscreen MCP and which store data each team member can access.

MCP Permissions are separate from the roles you manage in Team Management. Team Management controls what someone can access inside the Uscreen admin panel. MCP Permissions control what that person can access via an AI agent connected to the Uscreen MCP.

For example, a team member may have access to certain areas in the Uscreen admin panel, but still needs separate MCP permissions before their AI agent can read or store data.

📝 NOTE: Only the Store Owner can manage MCP Permissions to keep MCP access consistent, secure, and easy to track. Team members can connect an AI agent after access is granted, but they can't grant permissions to themselves or to other team members. If you need MCP access granted or changed, contact your Store Owner directly. Our support team also can't and will not adjust MCP access levels for any user.

Granting MCP Access to a Team Member

To grant access:

  1. In your Uscreen admin, go to Settings > MCP Permissions

  2. Find the team member you want to manage

  3. Choose Grant Access

  4. Select the MCP permissions you want that team member to have

  5. Save your changes

After access is granted, the team member can connect their AI agent to Uscreen MCP. During authorization, they’ll only be able to approve the permissions granted.

Edit or Revoke MCP Access

You can update a team member’s MCP permissions at any time.

Use Edit Scopes to change which permissions the team member has. Use Revoke Access to remove their MCP access entirely.

When permissions are edited or revoked, the team member’s existing AI connection may stop working until they re-authorize. If access is revoked, they won’t be able to use Uscreen MCP again unless the Store Owner grants access.

💡 TIP: Start with only the permissions a team member needs. You can add more later if their responsibilities change.


What You Can Do with Uscreen MCP

Uscreen MCP is designed to let you understand and manage your business through plain-language conversation.

Once connected, your AI agent can access the following areas of your Uscreen store:

Read Access

Permission

Description

Content analytics (read)

View how your content performs:

  • Top videos

  • Watch time

  • Per-video performance over time

Finance analytics (read)

View your business finances:

  • Revenue and MRR

  • Subscriber growth

  • Revenue breakdown by plan

CRM (read)

View your members:

  • List members, find them by email

  • View a member's profile, payments, emails, comments, and watch history

Catalog (CMS) (read)

View your catalog:

  • Videos, categories, collections

  • Live events

  • Tags and custom filters

Products (read)

List your products:

  • Subscription plans, one-time purchases, rentals, bundles, and free offers

  • Pricing and the content each one unlocks

Write Access

Permission

Description

Catalog (CMS) (edit)

Edit a content's details (videos, collections, and livestreams):

  • Title, description, short description

  • Organize with custom filters

  • Update SEO title and description

Add subtitle tracks (videos only)

Replace the thumbnail on a video, collection, or livestream (edit the preview before confirming)

CRM (edit)

Grant or revoke a member's access to a product (one-time, rental, bundle, or free offer) or to a single content item (video, collection, or live event)

Create, rename, and delete member tags

Apply or remove existing member tags on individual members

ℹ️ INFO: More capabilities are actively in development, including the ability to write and update content, manage subscriber information, and automate workflows.


Starter Prompts

Not sure where to start? Just ask.

Copy and paste any of these examples directly into your AI agent:

  • Monthly overview:

    • How's my business doing this month? Give me MRR, active subscribers, and trial count vs. last month, and call out any metric that moved more than 5% either direction.

  • At-risk members:

    • List members set to cancel at period end, plus anyone whose trial ends in the next 7 days. Group them by plan so I can see where cancellations are concentrated.

  • Revenue by plan:

    • Break down current MRR and active subscribers by plan, then compare total MRR to last month and tell me which direction it moved.

💡 TIP: Swap out any detail in these prompts, such as plan names, date ranges, or thresholds, to match what you actually want to know.


What’s Coming Next

The following capabilities are in development and not yet available:

  • Editing collection and live event metadata

  • Building automations through conversation with your AI agent


FAQs

What is the Model Context Protocol (MCP)?

MCP is an open standard that lets AI agents connect to external services and data sources. Uscreen MCP uses this standard so that AI clients like Claude Desktop can read and, eventually, interact with your Uscreen store, all without you having to export data or build custom integrations.

Which AI agents work with Uscreen MCP?

Any AI client that supports custom MCP connectors works with Uscreen MCP. Supported tools include Claude, Cursor, ChatGPT & Codex, and more. You add a custom connector in your AI tool, paste your Uscreen MCP URL, and log in with your Uscreen credentials.

Do I need to install anything?

No. Uscreen MCP is fully hosted, and there's nothing to download or run locally. You connect through your AI agents connector settings using a standard OAuth flow.

Is my store data secure?

Yes. Uscreen MCP uses OAuth with a consent screen, so you control exactly which permissions your AI client receives. Only you can authorize access to your store, and you can revoke access at any time.

Can I upload thumbnails for categories or offers through MCP?

Not yet, the thumbnail upload currently covers videos, collections, and livestreams. Category and offer thumbnails are planned as a follow-up.

Did this answer your question?