AI Agents (MCP)

StepsKit ships an MCP server, @stepskit/mcp, so your AI coding agent can install StepsKit and author product onboarding tours from inside your codebase. Because the agent already has your components and selectors on disk, the tours it drafts point at the right elements from the start.

It works with any MCP client — Claude Code, Cursor, Codex, Claude Desktop, and others. The server is the same everywhere; only the way you register it differs (see Connect your agent).

The flow

Status — the agent calls get_integration_status to see whether the embed is installed, which domains are allowed, and how many tours exist.
Install — if the embed isn't installed, the agent detects your framework and adds the snippet to the right file. You review the diff.
Verify — after you load a page once, verify_integration confirms the embed actually pinged StepsKit, so you know tours can render.
Domain — add_allowed_domain whitelists your production domain (localhost is always allowed).
Create — create_tour persists a tour from codebase context, as an unpublished draft.
Review & publish — you review the tour in the StepsKit dashboard and publish it deliberately. The agent never publishes on its own.

The tools your agent gets

Tool	What it does
`get_capabilities`	Lists what the MCP can and can't do right now, so the agent gives accurate answers instead of guessing.
`get_integration_status`	Reads onboarding state — embed installed?, allowed domains, tour count — plus a ready-to-paste install snippet.
`verify_integration`	Confirms the embed has pinged StepsKit and is live after install.
`add_allowed_domain`	Whitelists a production domain so tours play there.
`create_tour`	Authors an unpublished tour from codebase context. It never publishes.
`list_tours`	Lists the project's tours so the agent can pick one to edit.
`get_tour`	Reads one tour's full editable state — settings, visibility, and steps (with ids).
`update_tour_config`	Renames a tour and edits its behavior settings (buttons, labels, progress, …).
`update_tour_visibility`	Sets targeting, page URL pattern, minimum screen width, show-once frequency, and trigger.
`update_step` / `add_step` / `delete_step` / `reorder_steps`	Edits, adds, removes, and reorders steps. Editing keeps step ids (and analytics).

Next steps

Connect your agent — per-client setup for Claude Code, Cursor, Codex, and others.
Capabilities & limits — what you can and can't ask it to do.
Troubleshooting — when the server or a tour doesn't show up.