Using the Instant AI MCP | Instant Help Center

The Instant MCP (Model Context Protocol) server lets you build, edit, and publish Instant landing pages directly from an AI assistant—no browser required. Just describe what you want, and the AI builds it for you.

Overview

Connect your AI assistant to Instant and control page building through natural language prompts. The MCP works with any compatible AI agent such as Claude, Codex, and others.

Available Tools

Tool	What It Does
create_landing_page	Create a new empty landing page
send_message_to_agent	Instruct the AI to build or edit sections
get_agent_run	Check the status of an ongoing build
list_pages	See all pages in your project
get_page	Fetch a page's outline and optional screenshot
edit_page_settings	Update name, slug, or SEO metadata
publish_page	Publish the page to your connected Shopify store
unpublish_page	Remove a page from Shopify
get_project	View your project and Shopify store details
get_balance	Check your remaining AI build credits

Before You Begin

Make sure you have the following:

Requirement	Details
AI assistant	Claude Desktop, Codex, or any MCP-compatible AI agent
Node.js 18+	Required for npx (download from nodejs.org)
Instant account	With an active project

Step 1: Create an Access Token

Open your project in app.instant.so
Go to Project Settings → General → Access Tokens
Click Create new token
A modal appears with your token and installation options

Important: This is the only time you'll see the full token. Copy it now and store it somewhere safe—it cannot be shown again.

Step 2: Install the MCP

Choose one of the following installation methods.

Method 1: Claude Desktop One-Click Install

For Claude Desktop users, use the one-line install command shown in the modal:

Copy the Claude Desktop one-line install command from the modal
Run it in your Terminal
Restart Claude Desktop

The command automatically configures Claude Desktop to connect to Instant.

Method 2: Manual Configuration

For other MCP clients or manual setup, use your Personal access token from the modal.

Option A: HTTP Directly

Add this to your MCP client config file:

json

{ "mcpServers": { 
    "instant": { 
      "url": "https://api.instant.so/mcp", 
        "headers": { 
          "Authorization": "Bearer YOUR_TOKEN_HERE" 
        } 
      } 
    } 
}

Replace YOUR_TOKEN_HERE with your personal access token.

Option B: stdio via mcp-remote

json

{   
    "mcpServers": {     
      "instant": {       
        "command": "npx",
       "args": [
         "-y",
         "mcp-remote",
         "https://api.instant.so/mcp",
         "--header",
         "Authorization:Bearer YOUR_TOKEN_HERE"
       ]
     }
   }
 }

Replace YOUR_TOKEN_HERE with your personal access token.

Connection Details

Setting	Value
Endpoint	`https://api.instant.so/mcp`
Transport	Streamable HTTP (MCP spec, JSON-RPC over POST)
Authentication	`Authorization: Bearer pat_xxx` header on every request

Step 3: Restart Your AI Agent

Fully quit and relaunch your AI agent. The Instant tools will be available in your next conversation.

Important: A full restart is required—the MCP server connects at launch. Reloading a conversation without restarting will not load the tools.

Step 4: Build Your First Page

Once your AI agent has restarted, try this prompt to get started:

"Create a landing page for my store called 'Summer Sale', then build a hero section with a bold headline 'Up to 50% Off', a subheadline, and a CTA button. Use a red and white color theme."

The AI will:

Call create_landing_page to create the page
Call send_message_to_agent to instruct the AI builder
Poll get_agent_run until the build is complete
Return a link to preview the result in the Instant builder

Example Prompts

Task	What to Say
Create a page	"Create a landing page called X"
Build sections	"Build a hero, features, and product grid in a blue/white theme"
Edit a section	"Make the hero headline shorter and bolder"
List pages	"Show me all my Instant pages"
Publish to Shopify	"Publish the page"
Check credits	"How many AI credits do I have left?"

Troubleshooting

Issue	Solution
Tools not showing up	Fully quit and restart your AI agent—a reload is not enough
npx not found	Install Node.js 18+ from nodejs.org
Authentication error	Double-check your token in Project Settings → General → Access Tokens
Build takes a long time	Normal—a full landing page typically takes 1–5 minutes
Page not appearing in Shopify	Make sure your Shopify store is connected in Project Settings

Quick Reference

Task	Action
Create access token	Project Settings → General → Access Tokens → Create new token
One-click install (Claude)	Copy and run the one-line install command from the modal
Manual install	Add config with your token to your MCP client
Restart AI agent	Fully quit and relaunch
Create page	"Create a landing page called [name]"
Build sections	"Build a [section type] with [details]"
Publish page	"Publish the page"
Check credits	"How many AI credits do I have left?"