21st.dev Grid Notes
Community marketplace of React components, blocks, themes and shaders with a hosted MCP server (`https://21st.dev/api/mcp`) and per-component `shadcn add` commands.
Install and prerequisites
npx shadcn@latest add "https://21st.dev/r/<author>/<component>"shadcnFor the MCP server, create an API key at 21st.dev/mcp and set API_KEY_21ST in your environment (sent in the x-api-key header).
Framework setup
Connecting the 21st.dev remote MCP server
Pass API_KEY_21ST via the x-api-key header in your agent's MCP config; never hard-code the key in a committed .mcp.json.
{
"mcpServers": {
"21st-dev": {
"type": "http",
"url": "https://21st.dev/api/mcp",
"headers": {
"x-api-key": "${API_KEY_21ST}"
}
}
}
}Gotchas for agents
Legacy Magic console keys no longer work
Keys created in the older Magic MCP console are retired. Generate a fresh key at
https://21st.dev/mcpand pass it in thex-api-keyrequest header.Tool availability depends on account plan
searchandget_componentwork without paid AI credits;generateanditerate_generationonly appear when the account has AI generation access enabled.Review community-contributed code before shipping
Because 21st.dev is a multi-author community marketplace, inspect each installed component for hard-coded colours, external image URLs, missing
aria-labels and Tailwind v3-only utilities before committing.
Accessibility and reduced motion
Reduced motion
Community blocks rarely include prefers-reduced-motion guards out of the box; audit any motion or shader block against your project's reduced-motion rules before merging.
Keyboard and screen readers
Verify heading hierarchy (h1 → h2 → h3), focus outlines (focus-visible:outline-2) and AA contrast (4.5:1) on every imported community block.
More Grid Notes
- shadcn/uiCopy-in React components built on Base UI or Radix UI and Tailwind CSS v4, plus an official MCP server that searches and installs from any namespaced registry.
- React BitsAnimated text effects, shaders, cursors and interactive backgrounds installed as source code in four variants (`-JS-CSS`, `-JS-TW`, `-TS-CSS`, `-TS-TW`).
- Magic UIOver 150 animated landing-page components — marquees, Bento grids, shimmer buttons, globes and device mocks — built with React, Tailwind CSS and Motion.
- Aceternity UIDramatic landing-page hero sections, 3D card perspectives, spotlights, beams and macbook scroll effects built with React 19, Tailwind CSS v4 and Motion.
- Motion PrimitivesComposable, minimal React motion building blocks — animated groups, text effects, morphing dialogs, docks and carousels — built on Motion and Tailwind CSS.
- coss uiOpen-source React components built on Base UI (`@base-ui/react`) and Tailwind CSS v4 (formerly Origin UI; `originui.com` redirects here).



