SETUP GUIDE

Connect AI Box MCP to Cursor

2 min readUpdated Jul 1, 2026Works on all Cursor plans

This guide walks you through adding AI Box as an MCP server inside Cursor. Once it's set up, Cursor's agent can generate images for your UI, produce audio assets, and run any Box you've built — without you ever leaving the editor.

WHAT YOU NEED

Cursor installed (any plan works)
An AI Box account , sign up free if you don't have one
About 60 seconds of free time

1STEP 1

Open Cursor's MCP settings

In Cursor, open Settings (⌘⇧J on Mac, Ctrl+Shift+J on Windows) and select Tools & MCP in the sidebar. This is where Cursor lists every MCP server it can call.

Cursor · Settings

General

Models

Tools & MCP

Rules

Indexing

MCP Servers+ New MCP Server

github12 tools

playwright8 tools

2STEP 2

Add the AI Box server to mcp.json

Click New MCP Server. Cursor opens your mcp.json config file — paste the snippet below and save. Use ~/.cursor/mcp.json to make AI Box available in every project, or .cursor/mcp.json inside one repo to scope it there.

mcp.json

{
  "mcpServers": {
    "aibox": {
      "url": "https://mcp.aibox.ai/mcp/"
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "aibox": {
      "url": "https://mcp.aibox.ai/mcp/"
    }
  }
}

3STEP 3

Sign in to AI Box

Back in Tools & MCP, the aibox entry shows Needs login. Click it and your browser opens the AI Box authorization page — review the access and click Allow. The tools list populates within a few seconds.

Authorize Cursor

Cursor wants to connect to your AI Box account.

See your published Boxes

Run Boxes on your behalf

Read tool descriptions

DenyAllow

4STEP 4

Use it in Agent chat

Open the agent panel (⌘I) and ask for what you need. Cursor picks the right AI Box tool automatically — approve the call and the finished asset lands in your conversation, with a link back to your AI Box media storage.

Cursor · Agent

Use AI Box to generate an og-image for this landing page

aibox · generate_image

1200×630 · flux

Saved to public/og/home.png — want a darker variant for dark mode?

Generating variant.

TEST IT

Try one of these prompts

Paste any of these into Cursor's agent and watch it call AI Box for you — real assets, generated without leaving your editor.

UI ASSETS

"Use AI Box to generate a 1200x630 og-image for this landing page and save it to public/og/."

PLACEHOLDERS

"Generate six avatar images for the testimonials section — diverse, photorealistic, square."

AUDIO

"Use AI Box to create a short notification sound for this app and drop it in src/assets/."

TROUBLESHOOTING

Stuck? Try these first.

The aibox server shows no tools / a red dot+

Open mcp.json and check the JSON is valid — a trailing comma is the usual culprit — and that the URL is exactly https://mcp.aibox.ai/mcp/ including the trailing slash. Then toggle the server off and on in Tools & MCP.

I never got the browser login popup+

Click the aibox entry in Tools & MCP and choose Login/Reconnect. If nothing opens, your default browser may have blocked the popup — allow popups for cursor.com or copy the login URL Cursor prints in the MCP logs.

The agent doesn't use AI Box when I ask+

Mention AI Box by name the first time ('use AI Box to…'). Once the agent has used a tool in a project it reaches for it on its own. Also check the server is enabled in Tools & MCP.

My Boxes aren't showing up as tools+

Only Boxes you've published show up in MCP. Open the Box in AI Box, hit Publish, then refresh the aibox server in Tools & MCP.

Does this also work in Claude, ChatGPT, or other apps?+

Yes — the same MCP URL works in every MCP-compatible client. See our guides for Claude, ChatGPT, and Gemini, or the MCP overview for the full list of supported apps.

Still stuck?

We answer support tickets in under 4 hours on weekdays. Bring the specific error message you're seeing and we'll get you unblocked.

Talk to support Back to MCP