Book a discovery

Swifty Connect

Update Your Swifty Sites by Asking Claude

Read, audit, and update one property or an entire portfolio through a secure Swifty connection.

Swifty Connect is the official Swifty integration for Claude. It lets you read, audit, and update your Swifty property sites in plain English: update SEO, manage floor plans, amenities, FAQs, popups, social links, office hours, and tracking pixels; pull live performance data from Google Analytics, Search Console, Google Business Profile, and Google Ads; switch between properties in a single conversation; and batch updates across an entire portfolio. Every change is followed by an automatic cache clear.

Quick Start

Option 1: Claude.ai (recommended)

Use Claude on the web with one-click connection. Best for property managers, marketing teams, and on-site staff.

  1. Open Claude.ai and click Connect next to Swifty Connect in the connector directory (or paste this URL when prompted: https://mcp.beswifty.com/v1/mcp).
  2. You will be redirected to auth.beswifty.com to sign in with your Swifty account.
  3. Approve the requested scope. You will be redirected back to Claude with the connector active.
  4. Try: “List the Swifty properties I can manage.”

Option 2: Claude Desktop

Use Claude on macOS or Windows. Best for power users and developers.

  1. Install Claude Desktop from https://claude.ai/download.
  2. Get your personal Swifty API key from https://manage.beswifty.com/user-area/?admin-page=api.
  3. Open Claude Desktop’s settings file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

  1. Add this block under mcpServers:
{
  "mcpServers": {
    "swifty-connect": {
      "command": "npx",
      "args": ["-y", "swifty-connect"],
      "env": {
        "SWIFTY_API_KEY": "PASTE_YOUR_API_KEY_HERE"
      }
    }
  }
}
  1. Restart Claude Desktop. Type a Swifty question to confirm the tools loaded.

Option 3: Claude Code

Use Claude Code from the terminal. Best for ops, scripts, and automation.

  1. Install Claude Code: npm install -g @anthropic-ai/claude-code
  2. Add the Swifty Connect server:
claude mcp add swifty-connect npx -y swifty-connect \
  -e SWIFTY_API_KEY=PASTE_YOUR_API_KEY_HERE
  1. Run claude and start asking questions about your sites.

What You Can Do

Swifty Connect exposes 47 tools, grouped by purpose. The tool name is what Claude calls; the second column is what it does.

Property navigation

  • list_propertieslist every Swifty property the connected account can access
  • set_active_propertyswitch to a specific property for the next operations

Read content

  • get_pagesevery page on the site, with field names you’ll need for edits
  • get_seotitle tags, meta descriptions, H1s, schema for every page
  • get_site_infositewide name, address, phone, hours, branding
  • get_property_infoproperty type, units, square footage, default OG image
  • get_brandingprimary logo, footer logo, sticky logo, favicon, map marker
  • get_amenities / get_all_amenitiescommunity, in-unit, and pet amenities
  • get_floor_plans / get_all_floor_plans / get_floorplan_settingsunits, prices, availability
  • get_faqsfrequently asked questions, by category
  • get_specialspopups and slide-ins currently active
  • get_menusheader and footer navigation
  • get_office_hoursleasing office, maintenance, and pool hours
  • get_social_mediaFacebook, Instagram, LinkedIn, X, TikTok, YouTube links
  • get_gallery / get_mediagallery images and uploaded media
  • get_fee_transparencydisclosed fee schedule
  • get_website_configurationsitewide configuration flags
  • get_integrationsthird-party services connected to the site
  • get_tracking_codesinstalled tracking codes (chatbots, pixels, analytics)
  • get_playbookrecommended workflows for common tasks

Read analytics

  • get_site_analyticsGoogle Analytics 4 traffic data
  • get_search_consoleGoogle Search Console queries, clicks, impressions
  • get_search_performancekeyword rankings and search visibility
  • get_gbp_performanceGoogle Business Profile views, calls, direction requests
  • get_adwords_performanceGoogle Ads spend, conversions, ROI

Update content

  • update_page_sectionhero, intro, CTA, or SEO fields on a specific page
  • update_site_infositewide name, address, phone, hours
  • update_property_infoproperty metadata, including default OG image
  • update_amenitiesadd, remove, reorder amenity entries
  • update_menusreplace navigation (gated behind a confirmation token)
  • update_office_hoursupdate leasing or maintenance hours
  • update_social_mediaupdate social platform URLs
  • update_mediareplace or update uploaded media
  • update_specialupdate an existing popup or slide-in (destructive)
  • update_faqchange a single FAQ entry
  • update_integrationsconnect or disconnect third-party services
  • create_faqadd a new FAQ entry
  • delete_faqremove an FAQ entry (gated behind a confirmation token)

Add tracking and styling

  • add_tracking_codeinstall a tracking pixel or chatbot via approved provider templates (35+ supported, including EliseAI, Knock, GTM, GA4, Meta Pixel, CallRail, Hotjar)
  • add_custom_cssinject sanitized custom CSS

Operations

  • clear_cacheclear and regenerate the site cache. Run after any change.
  • batch_operationperform the same operation across multiple properties (gated behind a confirmation token)
  • confirm_operationfinalize a destructive operation that returned a confirmation token

Safety Annotations

Every tool is annotated so Claude can distinguish reads from writes and surface confirmation prompts before anything irreversible happens. Read-only tools (every get_* tool) carry readOnlyHint: true. Destructive tools (every update_*, delete_*, clear_cache, batch_operation) carry destructiveHint: true. Tools that touch many properties or remove content (delete_faq, update_menus when replacing, batch_operation) require a two-step confirmation: the tool returns a single-use 5-minute token, Claude tells you exactly what is about to happen, and only after your approval is confirm_operation(token) called to execute.

Troubleshooting

“Not authenticated” or “Bearer token required”

You are not signed in to Swifty Connect. In Claude.ai, click Connect on the Swifty Connect listing and complete the sign-in flow. In Claude Desktop or Claude Code, your SWIFTY_API_KEY is missing from the config. Get it from https://manage.beswifty.com/user-area/?admin-page=api and add it to the env block.

“No property selected”

Run list_properties first to see the IDs you can access, then set_active_property with one of those IDs. The connector keeps an active property per conversation.

“Tool not found” or “edit_page not found”

Claude is calling a tool name that doesn’t exist on Swifty Connect. Tell Claude to call get_playbook to see the canonical tool names. The most common mistake is edit_page: the real tool is update_page_section.

A write succeeds but the site doesn’t update

After every write, the connector calls clear_cache automatically. If you still don’t see the change after 30 seconds, refresh hard (Cmd-Shift-R or Ctrl-Shift-R). For floorplan or pricing data, the cache clear can take up to two minutes since it regenerates JSON snapshots.

“Invalid master API key” on FAQ create or update

This is a known backend authentication issue we are tracking. Until it is resolved, FAQ creation and update via Swifty Connect is blocked. Email support@beswifty.com and our team will make the change for you within one business day.

“Tracking code addition is currently restricted”

add_tracking_code is limited to 35+ approved provider templates (EliseAI, Knock, GTM, GA4, Meta Pixel, etc.) for SOC 2 reasons. If your provider isn’t on the supported list, email support@beswifty.com to request a new template.

A popup or slide-in doesn’t update with update_special

The special_id parameter is 1-based, not 0-based. If you see “No special was found”, check the id field on the response from get_specials and pass that value directly.

Updates worked yesterday and broke today

If reads still work but writes fail intermittently, your MCP transport may have disconnected. Have Claude re-list the available tools (this happens automatically when a new conversation starts, or you can force it by asking “What Swifty Connect tools are available?”). If the issue persists, email support@beswifty.com.

OAuth redirects to a “Login is not yet available” page

You may be testing during a maintenance window. Try again in 15 minutes, or contact support@beswifty.com if it persists.

Privacy, Security, and Compliance

  • All traffic is HTTPS-only (TLS 1.3 where the client supports it).
  • OAuth 2.0 with PKCE is used for Claude.ai authentication. Your password never leaves Swifty.
  • API keys for direct Claude Desktop / Claude Code use are scoped per-user and revocable from https://manage.beswifty.com/user-area/?admin-page=api.
  • All API calls are logged on Swifty’s backend (api.beswifty.com) and on the MCP layer for change attribution.
  • Swifty’s Privacy Policy: https://beswifty.com/privacy-policy/
  • Swifty’s Terms and Conditions: https://beswifty.com/terms-and-conditions/

Support

  • Email: support@beswifty.com
  • Swifty client portal: https://manage.beswifty.com
  • Connector status and known issues: this page

We respond to support requests within one business day. For Anthropic Connector Directory review questions, email jon@criterionb.com and we will respond same day.

Top