AllGoodInsp AGI
Submit Insights About MCP API
Sign in

MCP Integration Guide

AllGoodInsp provides an MCP (Model Context Protocol) server that lets AI tools query a curated collection of design references. Instead of generating from generic prompts, your AI can base its output on real design decisions from quality sites.

What you get

The MCP server exposes tools for searching sites by mood, purpose, or visual element, retrieving detailed design analysis (typography, layout, color, motion), and accessing design principles and reusable patterns distilled from the collection.

Authentication

Two authentication methods are available. Use whichever works best for your setup.

API Key Recommended. Generate a key from your account page and add it to your client config. No browser flow needed.
OAuth Browser-based authentication. Your MCP client opens a window to sign in with Google. Use this if your client doesn't support custom headers.

Setup with API Key

  1. Create an account

    Sign in with Google to create your AllGoodInsp account.

  2. Generate an API key

    Go to your account page and create an API key. Copy the key — it is shown only once.

  3. Add the MCP server to your client

    Add the following to your MCP client configuration, replacing YOUR_API_KEY with the key you generated:

    {
  "mcpServers": {
    "allgoodinsp": {
      "url": "https://mcp.allgoodinsp.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Client-specific setup

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "allgoodinsp": {
      "url": "https://mcp.allgoodinsp.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "allgoodinsp": {
      "url": "https://mcp.allgoodinsp.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add allgoodinsp \
  --transport http https://mcp.allgoodinsp.com \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -s user

VSCode

Open Command Palette, select "MCP: Add Server", choose HTTP, and add:

{
  "servers": {
    "allgoodinsp": {
      "url": "https://mcp.allgoodinsp.com",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Setup with OAuth

If your client doesn't support custom headers, use the OAuth flow instead:

  1. Create an account

    Sign in with Google to create your AllGoodInsp account.

  2. Add the MCP server to your client

    Add the following to your MCP client configuration (no API key needed):

    {
  "mcpServers": {
    "allgoodinsp": {
      "url": "https://mcp.allgoodinsp.com"
    }
  }
}
  3. Authenticate

    On first connection, your MCP client will open a browser window. Log in with your Google account to authorize access.

Supported clients

Any MCP client that supports Streamable HTTP transport will work. This includes:

Available tools

extract_essence(site_ids, brief) Primary tool — synthesize 2-5 references into a code-ready design brief with CSS variables, palette, typography, spacing, section structure, and design rules 5 cr
search_sites(query, category?) Search sites by mood, purpose, or description. Optional category filter 2 cr
get_site(site_id, detail?) Retrieve design analysis for a specific site. detail: summary (default) or full 1 cr
search_by_component(query) Find sites by design element (e.g. "hero with video background", "sticky navigation") 2 cr
get_methodology(layers?) Design methodology — layers: principles, craft, patterns, ia Free
get_principles(category?) Design principles for typography, layout, color, motion, or IA 1 cr
self_review() Post-implementation quality checklist — covers anti-patterns, craft quality, and IA structure Free

Usage & Pricing

Every account gets 75 free credits per month, which resets on the 1st. A typical design task (search + extract + reference lookups) uses around 15-25 credits including revisions, so the free tier covers 3-5 site builds per month.

If you need more, register a payment method from your billing page. Overage is billed at $0.01 per credit ($10 per 1,000 credits) at the end of each month. Without a card on file, access stops when free credits run out.

Example prompts

Once connected, try prompts like: