MCP server

Connect Claude, Codex, and other MCP clients to FlwKit at mcp.flwkit.com and manage apps, flows, screens, blocks, experiments, analytics, and templates.

Overview

FlwKit provides a hosted MCP server at https://mcp.flwkit.com/mcp.

This server lets AI coding agents and assistants use FlwKit tools to:

Manage apps and API keys
Create and update onboarding flows
Manage screens and blocks
Run and publish A/B tests
Read analytics and user journeys
Create flows from templates

Prerequisites

You need:

A FlwKit account
A FlwKit app in your dashboard
Your app-specific FlwKit API key

Use your own app API key from FlwKit dashboard. The hosted MCP server does not store a global key for all users.

Server details

Base URL: https://mcp.flwkit.com
MCP endpoint: https://mcp.flwkit.com/mcp
Health endpoint: https://mcp.flwkit.com/health

Authentication headers supported:

Authorization: Bearer <your_flwkit_api_key>
x-flwkit-api-key: <your_flwkit_api_key>

Setup with Claude Code

Add the server:

claude mcp add --transport http flwkit https://mcp.flwkit.com/mcp --header "Authorization: Bearer <YOUR_FLWKIT_API_KEY>"

Verify:

claude mcp list
claude mcp get flwkit

Remove:

claude mcp remove flwkit

Setup with Codex CLI

Export your key:

export FLWKIT_API_KEY="<YOUR_FLWKIT_API_KEY>"

Add the server:

codex mcp add flwkit --url https://mcp.flwkit.com/mcp --bearer-token-env-var FLWKIT_API_KEY

Verify:

codex mcp list
codex mcp get flwkit

Remove:

codex mcp remove flwkit

Setup with other MCP clients

Any client that supports streamable HTTP MCP can connect with:

URL: https://mcp.flwkit.com/mcp
Header: Authorization: Bearer <YOUR_FLWKIT_API_KEY>

If your client does not support Authorization, use:

Header: x-flwkit-api-key: <YOUR_FLWKIT_API_KEY>

First-use workflow

Use this sequence to avoid ID lookup issues:

Run list_apps or get_app
Run list_flows
Run list_screens for a flow
Run list_blocks for a screen
Create or update resources using returned IDs

Tool	Required input	What it does
`list_apps`	none	Lists apps available to the API key
`get_app`	none	Returns current app details
`create_app`	`name`	Creates a new app
`update_app`	none	Updates current app fields (`name`, `description`, `iconUrl`)
`delete_app`	none	Deletes current app permanently
`get_app_api_key`	none	Returns current app API key
`get_app_usage`	none	Returns plan usage and limits

Tool	Required input	What it does
`list_flows`	none	Lists flows in current app
`get_flow`	`flowId`	Gets one flow
`create_flow`	`name`, `key`	Creates a flow
`update_flow`	`flowId`	Updates flow fields
`delete_flow`	`flowId`	Deletes a flow permanently
`duplicate_flow`	`flowId`	Clones a flow
`list_flow_versions`	`flowId`	Lists flow versions
`publish_flow_version`	`flowId`, `versionId`	Publishes a specific version

Tool	Required input	What it does
`list_screens`	`flowId`	Lists screens in order
`create_screen`	`flowId`, `name`	Adds a screen to a flow
`update_screen`	`screenId`	Updates screen name or position
`delete_screen`	`screenId`	Deletes a screen
`reorder_screens`	`flowId`, `screenIds`	Reorders all screens

Tool	Required input	What it does
`list_blocks`	`screenId`	Lists blocks in order
`add_block`	`screenId`, `type`, `properties`	Adds a block
`update_block`	`blockId`	Updates properties or position
`delete_block`	`blockId`	Deletes a block
`reorder_blocks`	`screenId`, `blockIds`	Reorders all blocks

header, description, media, cta, choice, text_input, benefits_list, testimonial, progress_bar, spacer, footer, notification_permission, health_permission, tracking_permission, camera_permission, location_permission, microphone_permission, photo_library_permission, processing_animation, comparison_table, swipe_cards

Experiments (6)

Tool	Required input	What it does
`list_ab_tests`	none	Lists A/B tests
`get_ab_test`	`testId`	Gets A/B test details
`create_ab_test`	`name`, `flowId`, `variants`	Creates A/B test
`update_ab_test`	`testId`	Updates test fields
`publish_ab_test`	`testId`	Publishes draft test
`delete_ab_test`	`testId`	Deletes test permanently

Analytics (4)

Tool	Required input	What it does
`get_analytics_summary`	none	App-level summary metrics
`get_flow_analytics`	`flowId`	Flow completion and per-screen metrics
`get_screen_analytics`	`flowId`, `screenId`	Single-screen analytics
`get_flow_journeys`	`flowId`	User path journeys through a flow