freewebstore-mcp

MCP server for creating websites on FreeWebStore. Use from Claude Desktop or any MCP client — say "make me a website for my pizza shop" and get a live site deployed.

Quick start

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "freewebstore": {
      "command": "npx",
      "args": ["-y", "freewebstore-mcp"]
    }
  }
}

Then ask Claude: "Create a website for my yoga studio called Zen Flow in Portland"

How it works

Claude Desktop → stdio → freewebstore-mcp → HTTPS → agent.freewebstore.online → KV

The MCP server calls the FreeWebStore agent REST API. No API key needed — sites are free and deployed instantly to {slug}.freewebstore.online.

Tools (18)

Templates

| Tool | Description | |------|-------------| | list_templates | Browse 108 templates across 15 categories | | list_section_templates | Get 8 pre-built section snippets (pricing, FAQ, team, etc.) | | create_site | Start a new site from a template |

Sections

| Tool | Description | |------|-------------| | list_sections | See all sections (id, type, label, size) | | read_section | Read a section's HTML | | update_section | Replace section content | | patch_section | Find-and-replace within a section | | add_section | Add a new section (with optional before positioning) | | remove_section | Delete a section | | reorder_sections | Reorder sections by ID list | | bulk_update_sections | Update multiple sections in one call |

Metadata

| Tool | Description | |------|-------------| | set_meta | Set site title and SEO description | | set_contact | Set phone, email, address, hours | | set_social | Set social media links (Instagram, Facebook, etc.) |

Deploy

| Tool | Description | |------|-------------| | deploy | Publish site to {slug}.freewebstore.online | | push_update | Push changes to a live site (instant) | | get_status | Check deploy status and site URL | | get_preview | Get assembled HTML for review |

Template categories

Restaurant, Cafe, Bar, Salon, Fitness, Trades, Auto, Health, Professional, Creative, Retail, Food, Education, Hospitality, Recreation — 108 niches total.

Section types

hero, about, contact, menu, gallery, testimonials, pricing, faq, team, portfolio, hours, events, features, cta, stats, locations, classes, booking

Configuration

| Env var | Default | Description | |---------|---------|-------------| | FWS_AGENT_URL | https://agent.freewebstore.online | Agent API base URL |

Local development

# Run directly
npx tsx packages/mcp/src/index.ts

# Or build and run
pnpm --filter freewebstore-mcp build
node packages/mcp/dist/index.js

License

MIT