How to Connect Swipe Pages MCP to Codex Desktop

Step 1: Generate Your MCP API Key

Open your AI Page Builder dashboard and click on Settings in the bottom-left corner.
Click on MCP Keys.
Give your key a name and click generate.
Important: Copy the API Key and save it somewhere safe; you will need it in the next steps

Step 2: Open Your Codex Configuration File

Because Codex is configured via your local file system, you need to open its configuration folder. Choose the instructions below depending on whether you are using Windows or Mac.

Option A: On Windows (File Explorer)

Press Win + R on your keyboard to open the Run dialog box.
Type %USERPROFILE%\.codex\ and click OK.
A File Explorer window will open. Right-click on the file named config.toml.
Select Open with and choose Notepad (or any text editor or IDE).

Option B: On Mac (Finder)

Open Finder.
In the top menu bar, click Go and select Go to Folder.
Type ~/.codex/ in the search bar and press Enter.
Right-click (or two-finger tap) on the config.toml file.
Select Open With and choose TextEdit (or your favorite text editor).

Step 3: Add the Swipe Pages Block

Scroll to the very bottom of your config.toml file.
Paste the following configuration block given:
Replace YOUR_SWIPE_PAGES_API_KEY_HERE with the actual API key you copied in Step 1.
Save the file (Ctrl + S or Cmd + S).

[mcp_servers.swipepages]
url = "https://agentsapi.swipepages.com/mcp/connector"
enabled = true

[mcp_servers.swipepages.http_headers]
x-api-key = "YOUR_SWIPE_PAGES_API_KEY_HERE"

Step 4: Restart Codex

Close the Codex Desktop app completely.
Reopen Codex so it can load your new configuration.

Step 5: Test the Connection

Open a chat window in Codex.
Type the testing prompt to make sure Codex sees your tools:
"Give me the Tools you have from Swipe pages MCP"

Codex will list all available Swipe Pages building tools, confirming that the setup was successful!

Here are Example of what you can ask Codex to do for your Ai Page.

Once the connector is active, you can type natural prompts to manage your landing pages. Here are some examples of what you can do:

1. Audit and Review Your Pages

You can ask Claude to look through your project, find specific pages, or analyze your branding.

Prompt: "List all the pages in my project and find the one titled 'Summer Sale'."
Prompt: "Take a look at my homepage mysite.com branding using the scrape tool, and tell me what fonts and primary colors we are using."

2. Make Quick Text Edits

Instead of opening the builder, you can ask Claude to update text or change headers instantly.

Prompt: "Find the main hero block on my pricing page and change the headline from 'Start for Free' to 'Get Started Risk-Free for 14 Days'."
Prompt: "Look at the block with ID block_123 and fix the typo in the second paragraph."

3. Build & Move Sections

You can ask Claude to reorganize a page or insert new sections using existing HTML templates.

Prompt: "Insert a new call-to-action block right after the testimonial section on my landing page."
Prompt: "Rewrite the entire features block (block_456) to change it from a two-column layout to a three-column layout."

4. Check Availability & Publish

Claude can help you manage your links and push your pages live when they are ready.

Prompt: "Check if the URL mysite.com/blackfriday is available. If it is, go ahead and publish my promo page there."
Prompt: "Update the slug of my registration page to /webinar-thank-you and publish it."

5. Safety First (Destructive Actions)

For security, Claude will always ask for your explicit confirmation before deleting anything.

Prompt: "Delete the page titled 'Old Draft 2024'." (Claude will ask: "Are you sure you want to permanently delete this page? This cannot be undone.")

Cost-Saving Tip:

Running Swipe Pages through Codex uses your Codex subscription or It work on your Free Tier if you don't have subscription but it will be limit on free tier. This means you won't have to spend extra on your own OpenRouter tokens for BYOK users or Genie Credits for Subscription Users to build your pages!