AI Agent Integration

MCP Integration

Let AI agents discover, search, and install Patina components through the Model Context Protocol

What is MCP?

The Model Context Protocol (MCP) lets AI agents interact with external tools and data sources. Patina's MCP server gives agents read-only access to search our 289-item catalog, get installation commands, and understand component details—no authentication required for the free catalog.

What Agents Can Do

Search Catalog

Query 139 components, 122 blocks, and 28 shells by name, description, or category

Get Install Commands

Retrieve the exact npx shadcn command to install any item

Browse by Type

Filter by component/block/shell, category, or tier (free/pro)

No Auth Required

Free, public access for all catalog data—no OAuth, tokens, or rate limits

Available Tools

Search by name, description, or category. Optional filters: kind (component/block/shell),tier (free/pro)

list_catalog

List items with filters: kind, tier,category, limit

get_item

Get full details for a specific item by name: title, description, install command, dependencies, tier

get_install_command

Get the exact npx shadcn@latest add @patina/[name] command

Add to Cursor

1. Open Cursor Settings

Go to Settings → MCP Servers

2. Add Patina MCP Server

Use the following URL:

https://patina-ui.nstranquist.workers.dev/api/mcp

3. Start Using

Ask your AI agent to search Patina components, get install commands, or browse the catalog

Protocol

Server Info

GET

https://patina-ui.nstranquist.workers.dev/api/mcp

Returns server metadata, stats, and available endpoints

List Tools

GET

https://patina-ui.nstranquist.workers.dev/api/mcp/tools

Returns the list of available tools and their input schemas

Call Tool

POST

https://patina-ui.nstranquist.workers.dev/api/mcp

json

{
  "tool": "search",
  "arguments": {
    "query": "button",
    "kind": "component"
  }
}

Cursor Skill

Add this skill to help agents understand the Patina workflow:

https://patina-ui.nstranquist.workers.dev/skills/patina.md

View Skill File

Isolated Previews

Agents and CI can render individual components in isolation at chrome-less routes:

https://patina-ui.nstranquist.workers.dev/isolate/[name]

For example: /isolate/button or /isolate/hero-split. These routes are force-dynamic and render only the component preview without site navigation.

View Isolate Index

Machine-Readable Catalog

A plain-text catalog for LLMs is available at:

https://patina-ui.nstranquist.workers.dev/llms.txt

View llms.txt

Start Building with AI

156 free components, 133 pro items, and full MCP integration

Browse Components Read Documentation