# Fieldbook

A library of original interface components: React implementations rendered live on the site, with
Vue, Svelte, Astro and plain HTML versions, an anti-AI-slop design-guidance layer, and a remote MCP
server for coding agents.

## Site
- https://fieldbook.lizardi.mx/               Overview
- https://fieldbook.lizardi.mx/components      Component library (browse and search, live previews)
- https://fieldbook.lizardi.mx/components/category/<category>   One category
- https://fieldbook.lizardi.mx/guidance       Design guidance and the 30-trope ruleset
- https://fieldbook.lizardi.mx/scan           Score a page against the ruleset
- https://fieldbook.lizardi.mx/docs/mcp       MCP server: connection, auth, tools
- https://fieldbook.lizardi.mx/credits        Credits for the guidance datasets

## shadcn registry (open items public; members-only items need an API key)
- https://fieldbook.lizardi.mx/index/components.json          Browse/search summaries
- https://fieldbook.lizardi.mx/r/<framework>/<slug>.json      One installable registry item
Install a component: npx shadcn@latest add https://fieldbook.lizardi.mx/r/<framework>/<slug>.json
Frameworks: react (always), vue, svelte, astro, html (once the port passes its tests)

## MCP server
- Endpoint: https://fieldbook.lizardi.mx/api/mcp   (Streamable HTTP; bearer auth)
- Auth: an API key (create one in the dashboard) sent as "Authorization: Bearer <key>",
  or Clerk OAuth when configured.
- Protected-resource metadata: https://fieldbook.lizardi.mx/.well-known/oauth-protected-resource
- Tools: search_components, get_component, list_frameworks, get_install_command,
  get_design_guidance, generate_design_system, get_slop_rules, get_font_guidance, suggest_alternatives, score_page
- Connect (Claude Code):
  claude mcp add --transport http fieldbook https://fieldbook.lizardi.mx/api/mcp --header "Authorization: Bearer <YOUR_KEY>"