# AllGoodInsp

> A curated design reference database for AI and humans. Each site is analyzed for typography, layout, color, motion, and information architecture decisions. AI connects via MCP or REST API to retrieve structured design data and produce better web design output.

## Pages

- [About](https://allgoodinsp.com/about): What AllGoodInsp is and how sites are selected
- [Compare](https://allgoodinsp.com/compare): How AllGoodInsp differs from screenshot libraries and style extractors
- [MCP Integration Guide](https://allgoodinsp.com/docs/mcp): Connect AI tools via MCP (Model Context Protocol)
- [REST API Documentation](https://allgoodinsp.com/docs/api): Programmatic access to design reference data
- [Submit a Site](https://allgoodinsp.com/submit): Submit a site URL for inclusion in the collection

## MCP Server

- Endpoint: `https://mcp.allgoodinsp.com`
- Transport: Streamable HTTP with OAuth 2.1
- Supported clients: Claude Desktop, Claude Code, Cursor, Windsurf, Cline
- [extract_essence(site_ids, brief, aspect_overrides?, reference_intents?)](https://allgoodinsp.com/docs/mcp): Synthesize 2-5 references into a ready-to-save DESIGN.md — design tokens, CSS variables, typography, color, spacing, motion, section structure, and binding do's-and-don'ts
- [search_sites(query, category?, country?)](https://allgoodinsp.com/docs/mcp): Search sites by mood, purpose, or description
- [get_site(site_id, detail?)](https://allgoodinsp.com/docs/mcp): Retrieve design analysis for a specific site. detail: full (default) or summary
- [search_by_component(query, limit?, section?, imagery?, subject?, composition?, bg_tone?, type_scale?, ui_pattern?, color_system?)](https://allgoodinsp.com/docs/mcp): Find sites by design element (e.g. "hero with video background")
- [get_methodology(layers?)](https://allgoodinsp.com/docs/mcp): Design methodology. layers: principles, craft, patterns, ia
- [get_reference_guide()](https://allgoodinsp.com/docs/mcp): Deep-dive guide for reading and combining references
- [get_principles(category?)](https://allgoodinsp.com/docs/mcp): Design principles for typography, layout, color, motion, or IA
- [get_patterns()](https://allgoodinsp.com/docs/mcp): Reusable technique combinations distilled from the collection
- [self_review()](https://allgoodinsp.com/docs/mcp): Post-implementation checklist — verify output against the design rules and fix violations

## REST API

- Base URL: `https://api.allgoodinsp.com/v1`
- Authentication: Bearer token via API key (optional for read endpoints)
- [GET /sites](https://allgoodinsp.com/docs/api): List sites with filters (category, country, region, pagination)
- [GET /sites/:site_id](https://allgoodinsp.com/docs/api): Full design analysis for a site (authenticated, 1 credit)
- [GET /search?q=](https://allgoodinsp.com/docs/api): Semantic search across all sites; each response includes a next_step pointer to extract-essence
- [POST /extract-essence](https://allgoodinsp.com/docs/api): PRIMARY endpoint — synthesize 2-5 site_ids + a brief into a ready-to-save DESIGN.md (authenticated)
- [GET /taxonomy](https://allgoodinsp.com/docs/api): Categories, countries, regions with counts
- [GET /screenshots/:site_id](https://allgoodinsp.com/docs/api): Site screenshot as WebP image
- [POST /submissions](https://allgoodinsp.com/docs/api): Submit a site for review (authenticated)

## Optional

- [Privacy Policy](https://allgoodinsp.com/privacy)
- [Contact](https://allgoodinsp.com/contact)