DesignRevision MCP Tools Reference

Every tool an AI coding agent can call on DesignRevision MCP — with its parameters, what it returns, and example requests. This is the canonical reference for the server's API surface.

Endpoint

https://mcp.designrevision.com/mcp

Streamable HTTP. Listing tools needs no auth; calling a tool needs a bearer token from your account.

Credits

Discovery and metadata calls are lightweight.

Credits are spent when you pull a component's full source with get_item_source. Call whoami to check your remaining budget.

Last verified against the live server: July 2026.

Discovery Retrieval Utility Get a token →

Discovery

Find the right component or block. All discovery tools are cursor-paginated and lightweight to call.

search_items

Keyword search across every surface (blocks, components, hooks). Cursor-paginated.

Parameter	Type	Notes
`query`	string	Required. The search keyword.
`surface`	string	Optional filter — `blocks`, `components`, or `hooks`.
`limit`	integer	Default 25.
`cursor`	string	Pagination token from a previous call.

Returns: items[] of lightweight metadata (slug, title, surface, premium, deps), plus next_cursor and has_more.

list_items

List every item on one surface. Cursor-paginated.

Parameter	Type	Notes
`surface`	string	Required. `blocks`, `components`, or `hooks`.
`limit`	integer	Default 25.
`cursor`	string	Pagination token.

Returns: a paginated items[] list.

list_popular

Items ranked by real install counts. Cursor-paginated.

Parameter	Type	Notes
`surface`	string	Optional — restrict to one surface.
`limit`	integer	Default 25.
`cursor`	string	Pagination token.

Returns: a paginated items[] list, most-installed first.

list_block_categories

The block categories — hero, pricing, cta, dashboard, and more.

No parameters.

Returns: result[] of { slug, label, count }.

list_blocks_in_category

Every block slug inside one category, ready for get_item. Cursor-paginated.

Parameter	Type	Notes
`category`	string	Required. A category slug from `list_block_categories`.
`limit`	integer	Default 25.
`cursor`	string	Pagination token.

Returns: a paginated items[] list.

Retrieval

Read one item — metadata first, then its source when you've chosen it.

get_item

Lightweight metadata — title, deps, premium flag. No source. Call this first.

Parameter	Type	Notes
`slug`	string	Required. The item slug.

Returns: { slug, title, surface, premium, categories, deps, thumbnail_url, installs }.

get_item_details

Curated opening paragraph, related siblings, and FAQs for one item.

Parameter	Type	Notes
`slug`	string	Required. The item slug.

Returns: { slug, opening, related[], faqs[] }.

get_item_source

Metered — spends credits

Full registry JSON with TSX source inlined. Call only for an item you've chosen.

Parameter	Type	Notes
`slug`	string	Required. The item slug.

Returns: { slug, registry } — the full shadcn registry object with the component's TSX source inlined.

get_preview_url

Preview URLs — docs page, iframe, dark mode, screenshot.

Parameter	Type	Notes
`slug`	string	Required. The item slug.

Returns: { docs, iframe, dark, screenshot } URLs.

get_install_command

Ready-to-run shadcn add command with your token embedded.

Parameter	Type	Notes
`slug`	string	Required. The item slug.

Returns: a ready-to-run shadcn add command for the item.

Utility

Account and registry information. No parameters.

whoami

Your tier, remaining monthly/burst budget, email, and server time.

No parameters.

Returns: your plan tier, remaining credit budget, account email, and the current server time.

get_registry_stats

Top-level counts across every surface, plus the self-describing surface enum.

No parameters.

Returns: surfaces[] of { id, label, description, count }.

In preview: two additional icon tools — search_icons and get_icon — are registered on the server and coming soon. They aren't returning results yet, so they're not documented here.

Example: search, then install

Tools are called with the MCP tools/call method. A typical flow searches, then fetches the install command.

Request — search for a component

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_items",
    "arguments": { "query": "pricing table", "limit": 3 }
  }
}

Response (illustrative)

{
  "items": [
    {
      "slug": "pricing-02",
      "title": "Two-Tier Pricing",
      "surface": "blocks",
      "premium": false,
      "deps": ["card", "button"]
    }
  ],
  "has_more": false
}

Then — get the install command

{
  "method": "tools/call",
  "params": {
    "name": "get_install_command",
    "arguments": { "slug": "pricing-02" }
  }
}

Returns a ready-to-run shadcn add command, with your token embedded, that drops the real component into your project.

Ready to connect your agent?

Get a token and add DesignRevision MCP to Claude Code, Cursor, Codex, Windsurf, or Claude Desktop in one line.

Get started free Back to DesignRevision MCP

Setup guides: Claude Code Cursor Codex Windsurf Claude Desktop