DOCS · MCP

Connect ViewBait MCP

Hook Cursor, Claude, or ChatGPT into your ViewBait account so you can list projects, generate thumbnails, edit, and compare without leaving your AI client.

Your endpoint

This is the one string that has to be exact. Use www. Skip a trailing slash.

https://www.viewbait.app/api/mcp

Before you start

  • A ViewBait account you can sign into at viewbait.app
  • An MCP client that supports remote servers + OAuth
  • About two minutes for the first consent flow

Connect your client

Pick your client. Steps stay short on purpose so you can finish while the auth code is still fresh.

Best fit if you already live in Cursor. Add ViewBait as a remote MCP server, then authenticate once.

  1. Open Cursor Settings, then go to MCP (or Features → MCP).
  2. Add a new MCP server and choose a remote / URL-based server when prompted.
  3. Paste the ViewBait endpoint exactly (www host, no trailing slash).
  4. Save, then click Connect or Authenticate.
  5. Sign in to ViewBait if asked, then tap Allow on the consent screen.
  6. If the browser stays on ViewBait, click Continue so Cursor can finish the token exchange.

TipYou can also drop the JSON snippet below into your Cursor mcp.json.

mcp.json
{
  "mcpServers": {
    "viewbait": {
      "url": "https://www.viewbait.app/api/mcp"
    }
  }
}

What the consent screen means

Allow

Lets the client use ViewBait on your behalf: projects, assets, generation, edits, and comparisons within your plan.

Deny

Stops the connection. Nothing changes in Studio. You can reconnect later whenever you want.

How you know it worked

  1. Your client shows ViewBait as connected (not pending).
  2. Ask: “What’s my ViewBait plan and remaining credits?” That should hit get_account_context.
  3. Follow up with “List my ViewBait projects” to confirm project access.

Tools you unlock

ToolWhat it does
get_account_contextPlan, credits, and generation limits
list_projectsBrowse owned and shared projects
get_project_workspaceProject defaults and recent thumbnails
create_project / update_projectCreate or update project settings
list_generation_assetsStyles, palettes, and saved faces
list_thumbnailsFilter and page through thumbnails
generate_thumbnailsGenerate 1–4 thumbnails with normal credits
edit_thumbnailCreate an edited version of a thumbnail
compare_thumbnailsCreative comparison of 2–4 options

Stuck? Fix it fast

Consent only issues an authorization code. Your client still has to exchange it. Use exactly https://www.viewbait.app/api/mcp, click Continue if the browser stays on ViewBait, and retry Connect if you waited longer than about 10 minutes.

Ready to generate from chat? Open Studio if you still need styles, faces, or credits set up first.

Open StudioSign in