Flint logo
Back to docs
API Reference

Flint Plugin for Claude Code

Build and manage Flint websites through natural conversation in Claude Code. The plugin bundles everything you need in a single install: the Flint MCP server, OAuth authentication, and an edit-site skill.

What's included

  • •/flint:edit-site skill: A guided workflow that finds your site, runs a background design agent, monitors progress, and returns a preview URL
  • •Flint MCP server: Four tools: list_sites, run_background_agent, check_background_agent_status, and publish_site
  • •OAuth authentication: Sign in to Flint directly from Claude Code with no manual config

Installation

Install from the Claude Code plugin marketplace:

text
/plugin install flint

Then authenticate with your Flint account:

text
/mcp

Select "Authenticate" for Flint and complete the browser login flow.

Usage

Once authenticated, just ask Claude to work on your site:

  • •"Create a changelog page documenting the features we shipped this week based on our recent git commits"
  • •"I just added OAuth support - update our docs site with a new authentication guide explaining the flow"
  • •"Publish my site"

Or invoke the skill directly:

text
/flint:edit-site Redesign the about page with a team section and company timeline

How it works

When you ask Claude to edit a Flint site, the plugin:

  1. 1.Calls list_sites to find your available sites
  2. 2.Sends your request to a background Flint AI agent via run_background_agent
  3. 3.Monitors progress (a single change typically takes 4-5 minutes)
  4. 4.Returns a summary and preview URL when complete

Flint is an expert web designer. It produces its best work when you describe goals and intent rather than implementation details. Requests like "make the header black" or "use a three-column grid" are honored directly, but let Flint handle layout, styling, and component decisions when you can.

Tips

  • •Describe goals, not implementation: "Add a section that builds trust with enterprise buyers" beats "Add a 3-column grid with testimonial cards"
  • •Pass through reference material: Code snippets, embed scripts, or example HTML can be included and Flint will incorporate them
  • •Be specific when you want to be: Explicit requests are honored as-is

Alternative setup

If you prefer to configure the MCP server manually without the plugin, see the Claude Code MCP setup guide.

Support