Skip to content
thumbnailup

ThumbnailUp MCP

Give your AI assistant better thumbnail references.

Connect ThumbnailUp to your assistant. Search the thumbnail library, compare ideas and get feedback on your draft without leaving the conversation.

Set up your assistantView Premium

The instructions are public. A ThumbnailUp account with Premium is required to approve a connection and use the tools.

Research with real references

Search indexed YouTube thumbnails by topic and compare examples with source links and coverage information.

Explore thumbnail directions

Use library examples to discuss composition, focal points and title pairings for your next video.

Review your draft

Submit a draft with your permission and get visual feedback, title fit and prioritized edits. Reviews save to your account.

Set up your assistant

Choose your client below and follow the steps to add ThumbnailUp in its settings. Then sign in and approve access to your account.

Remote MCP URL

Use this with a client that supports remote HTTP MCP and OAuth.

https://thumbnailup.com/api/mcp

ChatGPT

Bring thumbnail references and draft reviews into your ChatGPT conversations.

Before you connect

Use ChatGPT on the web. Your account or workspace must allow custom MCP connections.

  1. Open chatgpt.com/plugins. Click the plus button and choose Add custom MCP server.
  2. Enter ThumbnailUp as the name. For the description, enter YouTube thumbnail research and draft reviews.
  3. Under Connection, choose Server URL and paste the MCP URL below.
  4. Choose OAuth or no authentication so ChatGPT can discover the tools before connecting your account. Use automatic client registration if asked. Leave client ID and client secret empty.
  5. Read ChatGPT's connection warning, confirm if you agree, then choose Create as a plugin.
  6. Install the ThumbnailUp plugin. When prompted, sign in to your ThumbnailUp Premium account and approve access. Return to ChatGPT to finish connecting.
  7. In a chat, type @ and select ThumbnailUp before sending your research or review request.
https://thumbnailup.com/api/mcp

If the option to add a server is missing or disabled, check your workspace permissions or ask your administrator.

Official ChatGPT connection guide

Codex

Use ThumbnailUp's research and review tools in Codex.

Before you connect

Use the desktop app's MCP server settings. The CLI and IDE extension share the same configuration.

  1. Open Settings → MCP servers and choose Add server.
  2. Name it ThumbnailUp, choose Streamable HTTP and paste the MCP URL below. Leave token and additional header fields empty.
  3. Save the server and select Restart to refresh its tools.
  4. Select Authenticate for ThumbnailUp if sign-in is required. Approve access in your browser with your ThumbnailUp Premium account. If you are already signed in there, you only need to approve the connection.
  5. Return to your chat and ask Codex to run ThumbnailUp's check_connection tool.
https://thumbnailup.com/api/mcp

You do not need to create an API key, choose a callback port or supply OAuth client credentials. If the tools are missing after connecting, refresh the MCP server and start a new chat.

Official Codex MCP guide

Claude

Connect your Claude conversations to the ThumbnailUp library and review tools.

Before you connect

The individual setup uses Claude Pro or Max. On Team or Enterprise, an authorized workspace owner must add the connector first.

  1. Open claude.ai and go to Customize → Connectors.
  2. Click + Add, then Add custom connector.
  3. Name it ThumbnailUp, paste the MCP URL below and click Continue.
  4. Keep OAuth authentication, continue, then choose Sign in now.
  5. Under OAuth client, select Register automatically. Leave additional request headers empty.
  6. Click Add. Complete ThumbnailUp sign-in and approve access with your Premium account. If sign-in does not open, click Connect beside the saved connector.
  7. In your chat, open the + menu, choose Connectors and enable ThumbnailUp.
https://thumbnailup.com/api/mcp

For Team or Enterprise, the owner adds it through Organization settings → Connectors → Add → Custom → Web. Members then connect through Customize → Connectors.

Official Claude connection guide

Gemini

Add ThumbnailUp to Gemini's connected apps and use it in your chats.

Before you connect

Google currently limits custom apps to users aged 18+ in the US, using English, a personal Google Account and Keep Activity turned on. Work and school accounts are excluded.

  1. On a computer, open gemini.google.com and sign in to your personal Google Account.
  2. Open Settings → Connected Apps. If your menu shows Personal Intelligence first, open it and then Connected Apps.
  3. Find Custom apps and choose Add a custom app, or use the link field if this is your first connection.
  4. Paste the MCP URL below and click Next. ThumbnailUp supports automatic registration, so leave optional advanced client credentials empty.
  5. Follow Google's connection prompts, sign in to your ThumbnailUp Premium account and approve access.
  6. In a chat, type @ and select ThumbnailUp to use it in your request.
https://thumbnailup.com/api/mcp

Add the connection on Gemini's website. Once connected, Google also makes it available in the Gemini mobile app.

Official Gemini connection guide

Other MCP assistants

Connect another assistant that supports remote MCP connections.

Before you connect

Your assistant needs remote HTTP MCP, OAuth sign-in and automatic client registration. Menu names vary by provider.

  1. Open your assistant's MCP connections or integrations settings and add a remote server.
  2. Name the connection ThumbnailUp and paste the MCP URL below. If a transport is requested, choose HTTP or Streamable HTTP.
  3. Choose OAuth with automatic client registration. Complete the browser sign-in with your ThumbnailUp Premium account and approve access.
  4. Enable the saved connection's tools in your assistant before making a ThumbnailUp request.
https://thumbnailup.com/api/mcp

For Cursor Cloud, open cursor.com/agents and add the HTTP server through the MCP dropdown. Authorize it with your own account and enable it for the agent. Other assistants have their own setup menus.

Official Cursor Cloud connection guide

Add the ThumbnailUp skill

For assistants that support skills, connect MCP first. Download the skill and save it as thumbnailup/SKILL.md in your assistant's skills directory. Reload skills, then ask it to use ThumbnailUp for research or a draft review. The skill explains the workflow; MCP gives it access to your account's tools.

Download skill

Setup help