@swft-checkout/mcp

MCP server for Swft Checkout. Lets Claude and other AI assistants query your checkout analytics, sessions, billing, and merchant data directly.

Installation

Claude Desktop

Add to your Claude Desktop config file:

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

{
  "mcpServers": {
    "swft": {
      "command": "npx",
      "args": ["-y", "@swft-checkout/mcp"],
      "env": {
        "SWFT_API_KEY": "your_merchant_api_key_here"
      }
    }
  }
}

Restart Claude Desktop after saving. You'll see "swft" appear in the tools panel.

Custom API URL

If you're self-hosting or using a staging environment:

{
  "mcpServers": {
    "swft": {
      "command": "npx",
      "args": ["-y", "@swft-checkout/mcp"],
      "env": {
        "SWFT_API_KEY": "your_merchant_api_key_here",
        "SWFT_API_URL": "https://api.staging.swft.co.uk"
      }
    }
  }
}

Tools

swft_analytics

Checkout performance overview: sessions started, completed, abandoned, and conversion rate. Optionally includes billing summary.

Parameters:

• range — 7d, 30d, or 90d (default: 30d)
• include_billing — true to add GMV and fee breakdown (default: false)

Example prompts:

• "What's my checkout conversion rate this month?"
• "How is Swft performing over the last 90 days?"
• "Show me checkout analytics including billing"

swft_sessions

Lists recent checkout sessions with customer email (masked), date, and WooCommerce order reference.

Parameters:

• range — 7d, 30d, or 90d (default: 7d)
• limit — number of sessions to return, max 50 (default: 10)

Example prompts:

• "Show me the last 20 checkout sessions"
• "List sessions from the past week"

swft_merchant_info

Returns your merchant account details: store URL, Stripe connection status, custom domain, checkout template, and webhook URL.

Example prompts:

• "Is my Stripe account connected?"
• "What domain is my Swft checkout on?"
• "Show my merchant account details"

swft_recovery_stats

Abandoned cart recovery email performance broken down by the three recovery steps (30 min, 24 hr, 72 hr): emails sent, conversions, and recovery rates per step.

Parameters:

• range — 7d, 30d, or 90d (default: 30d)

Example prompts:

• "Show me my abandoned cart recovery stats"
• "How well are my recovery emails performing?"
• "Which recovery email step converts best?"

swft_billing

Total GMV processed through Swft, platform fees paid, net revenue, and average order value.

Parameters:

• range — 7d, 30d, or 90d (default: 30d)

Example prompts:

• "How much have I paid in Swft fees this quarter?"
• "What's my total GMV through Swft this month?"
• "Show me average order value for the last 30 days"

swft_ab_results

A/B test results if a test is configured: variant names, sessions per variant, conversion rates, and which variant is currently winning.

Example prompts:

• "Is my A/B test showing a winner?"
• "How are my checkout variants performing?"
• "Which checkout template converts better?"

swft_list_merchants — Agency only

Lists all merchant accounts under your agency with their Stripe status and 30-day conversion rates. Requires an agency API key.

Example prompts:

• "List all my client merchants and their conversion rates"
• "Which of my clients has the lowest conversion rate?"
• "Show me all merchants under my agency"

Agency Usage

Agency accounts work identically — use your agency API key instead of a merchant key. The swft_list_merchants tool becomes available, returning data across all merchants you manage.

{
  "mcpServers": {
    "swft": {
      "command": "npx",
      "args": ["-y", "@swft-checkout/mcp"],
      "env": {
        "SWFT_API_KEY": "your_agency_api_key_here"
      }
    }
  }
}

Local Development

cd sdk/mcp
npm install
npm run build
node dist/index.js

The server requires SWFT_API_KEY to be set in the environment before starting.