# 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
- [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)](https://allgoodinsp.com/docs/mcp): Synthesize 2-5 references into a code-ready design brief (CSS vars, typography, color, spacing, sections, fixed/explorable boundaries)
- [search_sites(query)](https://allgoodinsp.com/docs/mcp): Search sites by mood, purpose, or description
- [get_site(site_id)](https://allgoodinsp.com/docs/mcp): Retrieve full design analysis for a specific site
- [search_by_component(query)](https://allgoodinsp.com/docs/mcp): Find sites by design element (e.g. "hero with video background")
- [get_methodology()](https://allgoodinsp.com/docs/mcp): Design methodology — principles, craft, patterns, IA
- [get_reference_guide()](https://allgoodinsp.com/docs/mcp): Deep-dive guide for reading and combining references
- [get_workflow()](https://allgoodinsp.com/docs/mcp): Autonomous workflow for design system construction
- [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

## 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
- [GET /search?q=](https://allgoodinsp.com/docs/api): Semantic search across all sites
- [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)