The MCP server

Authentication

Every request carries a bearer token. Two kinds work:

• API key (available now)

  Create a key in your dashboard and send it as Authorization: Bearer fb_live_…. Keys are shown once; only a hash is stored.

• Clerk OAuth (when configured)

  OAuth-capable clients discover the authorization server from /.well-known/oauth-protected-resource and authenticate interactively. No manual key needed.

Connect

claude mcp add --transport http fieldbook https://fieldbook.lizardi.mx/api/mcp --header "Authorization: Bearer <YOUR_KEY>"

{
  "mcpServers": {
    "fieldbook": {
      "url": "https://fieldbook.lizardi.mx/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KEY>"
      }
    }
  }
}

npx @modelcontextprotocol/inspector

Tools

Metered tools spend credits from your monthly allowance (the owner plan is unmetered). Everything else is free and rate-limited per key.

• search_componentsFree

  query?, category?, framework?, maxSlopScore?, limit (max 25)

  Search the library; returns summaries with tested frameworks, slop score, plate, controls count and install commands.

• get_component1 credit

  slug, framework (default react)

  Source for one framework: React returns the component and its demo; ports return one file. Includes controls, dependencies, slop reading, security scan, install command.

• list_frameworksFree

  slug

  Which frameworks a component ships in, and which ports are still pending.

• get_install_commandFree

  slug, framework (default react)

  shadcn install command, registry URL, and a components.json snippet.

• get_design_guidanceFree

  query?, domain?, stack?, productType?, limit?

  Search the anti-slop guidance corpus.

• generate_design_system2 credits

  productType, keywords?, stack?, variance?, motion?, density?

  Generate a non-generic design system: palette, type, layout, motion, UX rules, checklist.

• get_slop_rulesFree

  category?

  The versioned trope ruleset (number, title, severity, hard-fail, rationale).

• get_font_guidanceFree

  role?, family?, name?

  How each recommended typeface looks and behaves, with tested pairings and the principles behind them.

• suggest_alternativesFree

  ruleId

  Antidotes for a trope plus the relevant antidote catalog.

• score_pageFree

  html? | url?

  Score a page against the ruleset (URL fetched behind an SSRF guard).

Registry

The library is a shadcn registry: install any component directly, or wire the whole registry once in components.json and add with @fieldbook/<name>. Set FIELDBOOK_TOKEN for metered pulls.

{
  "registries": {
    "@fieldbook": {
      "url": "https://fieldbook.lizardi.mx/r/react/{name}.json",
      "headers": {
        "Authorization": "Bearer ${FIELDBOOK_TOKEN}"
      }
    }
  }
}