# Widgetjoy

> Website widgets that look like the site built them. A site installs one script once; every
> widget after that is created, configured and published from Widgetjoy — by a person in the
> Dashboard, or by an AI agent over MCP, through the same procedures.

## What it is

- One loader script per site: `<script src="https://widgetjoy.com/loader.js" data-site="…" async></script>`
- Widgets render into the page in a Shadow DOM, take the site's font and the colour and corners chosen in the Studio, and are built to WCAG 2.2 AA.
- Every publish writes an immutable revision; going back writes another one.
- What visitors send arrives in one Inbox.

## For agents

- MCP endpoint: https://widgetjoy.com/mcp (Streamable HTTP, stateless, bearer token)
- A person creates an agent token in the Dashboard under Agents. The agent acts with that person's access.
- Tools are generated from the procedure contract; start with `widget_type_list` and `site_list`.
- REST: https://widgetjoy.com/api/v1 — OpenAPI document at https://widgetjoy.com/api/openapi.json

## Widgets

- [Announcement Bar](https://widgetjoy.com/widgets/announcement-bar): Say one thing at the top or bottom of every page, and let visitors dismiss it.
- [Contact Form](https://widgetjoy.com/widgets/contact-form): Let visitors send you a message, with the topic they picked, straight to your Inbox.
- [Countdown Timer](https://widgetjoy.com/widgets/countdown-timer): Show the time left until a moment you choose, and what happens when it runs out.
- [Age Verification](https://widgetjoy.com/widgets/age-verification): Ask for confirmation before the page is shown. (coming soon)
- [Call-to-Action Button](https://widgetjoy.com/widgets/call-to-action-button): Put one action in front of a visitor, wherever it belongs. (coming soon)
- [Popup](https://widgetjoy.com/widgets/popup): Interrupt deliberately, on a trigger you choose and a cadence visitors can bear. (coming soon)
- [Feedback Form](https://widgetjoy.com/widgets/feedback-form): Collect opinions with a rating, a category and a follow-up question. (coming soon)
- [Form Builder](https://widgetjoy.com/widgets/form-builder): Build any form from a field palette, with conditional logic and typed answers. (coming soon)
- [Newsletter Signup](https://widgetjoy.com/widgets/newsletter-signup): Grow a mailing list, with consent evidence recorded against every signup. (coming soon)
- [Poll](https://widgetjoy.com/widgets/poll): Ask one question and show the running result. (coming soon)
- [Testimonial Collection](https://widgetjoy.com/widgets/testimonial-collection): Ask customers for a testimonial and moderate what arrives. (coming soon)
- [Business Hours](https://widgetjoy.com/widgets/business-hours): Show when you are open, in the visitor's timezone, with exceptions. (coming soon)
- [Instagram Feed](https://widgetjoy.com/widgets/instagram-feed): Show a synchronised Instagram feed, with the filtering you choose. (coming soon)
- [Map or Store Locator](https://widgetjoy.com/widgets/map-store-locator): Help a visitor find the nearest location, with filters that matter. (coming soon)
- [RSS Feed](https://widgetjoy.com/widgets/rss-feed): Show items from any feed, refreshed on a schedule. (coming soon)
- [YouTube Gallery](https://widgetjoy.com/widgets/youtube-gallery): Show videos from a channel or playlist, kept in sync. (coming soon)
- [Before-and-After Slider](https://widgetjoy.com/widgets/before-and-after-slider): Let visitors drag between two images to see the difference. (coming soon)
- [Photo Gallery](https://widgetjoy.com/widgets/photo-gallery): Show images in a grid or lightbox, without a layout shift. (coming soon)
- [Video Gallery](https://widgetjoy.com/widgets/video-gallery): Show a set of videos without loading a player until it is wanted. (coming soon)
- [WhatsApp Chat](https://widgetjoy.com/widgets/whatsapp-chat): Hand a visitor straight to a conversation, on the channel they already use. (coming soon)
- [Changelog](https://widgetjoy.com/widgets/changelog): Publish what shipped, in a feed visitors can subscribe to. (coming soon)
- [Comparison Table](https://widgetjoy.com/widgets/comparison-table): Compare options row by row without writing a table by hand. (coming soon)
- [FAQ](https://widgetjoy.com/widgets/faq): Answer the questions that would otherwise become support tickets. (coming soon)
- [Google Reviews](https://widgetjoy.com/widgets/google-reviews): Show reviews synchronised from a place listing, filtered as you choose. (coming soon)
- [Logo Showcase](https://widgetjoy.com/widgets/logo-showcase): Show the customers or partners worth naming. (coming soon)
- [Pricing Table](https://widgetjoy.com/widgets/pricing-table): Lay out plans side by side, with the emphasis where it earns its keep. (coming soon)
- [Team Showcase](https://widgetjoy.com/widgets/team-showcase): Introduce the people behind the site. (coming soon)
- [Testimonials Display](https://widgetjoy.com/widgets/testimonials-display): Show collected testimonials as a wall, slider or grid. (coming soon)
- [Timeline](https://widgetjoy.com/widgets/timeline): Tell a story in order, from founding to today. (coming soon)