MCP Server

native-mate ships an MCP (Model Context Protocol) server that lets AI tools like Claude Code and Cursor browse, search, and add components directly from chat.

Setup with Claude Code

bash

claude mcp add native-mate -- npx @native-mate/mcp

This registers the native-mate MCP server. Claude can now list, search, and fetch component source code during conversations.

Setup with Cursor

Add to your .cursor/mcp.json:

.cursor/mcp.json

{
  "mcpServers": {
    "native-mate": {
      "command": "npx",
      "args": ["@native-mate/mcp"]
    }
  }
}

Available tools

Tool	Description
list_components	List all available components, optionally filter by category
get_component	Get full source code, dependencies, and version for a component
search_components	Search components by description or use-case keyword
generate_theme_config	Generate a native-mate.json config for a preset with optional overrides
get_add_command	Get the exact CLI command to add specific components

Example usage

Once the MCP server is connected, you can ask your AI assistant things like:

“Show me the source code for the Button component”
“What components are available for forms?”
“Search for components that handle modals or overlays”
“Generate a midnight theme config with a custom primary color”
“What command do I run to add card, input, and badge?”

How it works

The MCP server uses the same GitHub-hosted registry as the CLI. It fetches component metadata and source code on demand via raw.githubusercontent.com. No API keys or authentication required.