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. You land on your account page, where the API key button is.

  2. Generate an API key

    On the account page, click New Key. Copy it — it is shown only once. The page then shows this config and a test command with your key filled in.

  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

claude_desktop_config.json only loads local (stdio) servers, and custom connectors cannot send headers — so Claude Desktop uses the OAuth setup below, no key needed: Settings → Connectors → Add custom connector → paste https://mcp.allgoodinsp.com → sign in with Google when the window opens.

Claude Code

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

Or in a project .mcp.json — the "type": "http" line is required there:

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

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"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json uses serverUrl instead of url; headers works the same.

Cline

Add the server from Cline's MCP settings (file cline_mcp_settings.json) with the same URL and Authorization header.

Setup with OAuth

If you prefer not to use a key, or your client cannot send headers, use the OAuth flow instead:

  1. No separate account step

    The Google sign-in window that opens on first connection creates your AllGoodInsp account. Already have an account on this site? Choose the same Google account in that window — accounts are matched by Google email, so a different Google account creates a second AllGoodInsp account.

  2. Claude Desktop

    Settings → Connectors → Add custom connector → paste https://mcp.allgoodinsp.com. There is no config file to edit; claude_desktop_config.json only loads local servers.

  3. Cursor, Claude Code, VS Code

    Cursor (.cursor/mcp.json):

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

    Claude Code: claude mcp add allgoodinsp --transport http https://mcp.allgoodinsp.com -s user (no --header), or the same JSON in .mcp.json with "type": "http" added. VS Code: the same entry under servers instead of mcpServers.

  4. Authenticate

    On first connection, your MCP client opens a browser window. Log in with your Google account to authorize access. If a paid tool later answers that it needs an AllGoodInsp account, follow the fix given in that message. For "authorized before email verification was recorded", remove the connector (Claude Desktop) or the server entry (other clients) and add it again so the Google sign-in runs once more.

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 ready-to-save DESIGN.md: design tokens, CSS variables, palette, typography, spacing, motion, section structure, and binding do's-and-don'ts 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, buy a credit pack (1,000 credits for $10, never expires) or register a payment method for month-end overage billing at $0.01 per credit — both from your billing page. Without a pack or card, access stops when free credits run out.

Example prompts

Once connected, try prompts like: