@shadsapp/mcp 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +65 -0
  2. package/package.json +5 -4
package/README.md ADDED
@@ -0,0 +1,65 @@
1
+ # @shadsapp/mcp
2
+
3
+ [MCP](https://modelcontextprotocol.io) server for [shads.app](https://shads.app) theme discovery and validation.
4
+
5
+ Lets AI agents list public themes, fetch theme bundles, and validate `theme.json` documents.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ npm install @shadsapp/mcp
11
+ ```
12
+
13
+ ## Cursor / Claude Desktop config
14
+
15
+ ```json
16
+ {
17
+ "mcpServers": {
18
+ "shads": {
19
+ "command": "npx",
20
+ "args": ["-y", "@shadsapp/mcp"]
21
+ }
22
+ }
23
+ }
24
+ ```
25
+
26
+ Or use the built binary after install:
27
+
28
+ ```json
29
+ {
30
+ "mcpServers": {
31
+ "shads": {
32
+ "command": "shads-mcp"
33
+ }
34
+ }
35
+ }
36
+ ```
37
+
38
+ ## Tools
39
+
40
+ | Tool | Description |
41
+ |------|-------------|
42
+ | `list_themes` | List curated public starter themes |
43
+ | `get_theme` | Get `theme.json` + `theme.css` for a theme id |
44
+ | `validate_theme` | Validate a `theme.json` string |
45
+ | `theme_schema` | Return the active schema id (`shads-theme/v1`) |
46
+
47
+ ## Example: get workspace theme
48
+
49
+ Tool: `get_theme`
50
+
51
+ ```json
52
+ { "id": "workspace" }
53
+ ```
54
+
55
+ Returns theme metadata, parsed document, and CSS.
56
+
57
+ ## Related packages
58
+
59
+ - [`@shadsapp/schema`](https://www.npmjs.com/package/@shadsapp/schema)
60
+ - [`@shadsapp/themes`](https://www.npmjs.com/package/@shadsapp/themes)
61
+ - [`@shadsapp/cli`](https://www.npmjs.com/package/@shadsapp/cli)
62
+
63
+ ## License
64
+
65
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shadsapp/mcp",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "MCP server for shads theme discovery and validation",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -8,7 +8,8 @@
8
8
  "shads-mcp": "./dist/index.js"
9
9
  },
10
10
  "files": [
11
- "dist"
11
+ "dist",
12
+ "README.md"
12
13
  ],
13
14
  "exports": {
14
15
  ".": {
@@ -22,8 +23,8 @@
22
23
  },
23
24
  "dependencies": {
24
25
  "@modelcontextprotocol/sdk": "^1.17.5",
25
- "@shadsapp/schema": "0.1.0",
26
- "@shadsapp/themes": "0.1.0"
26
+ "@shadsapp/schema": "0.1.1",
27
+ "@shadsapp/themes": "0.1.1"
27
28
  },
28
29
  "publishConfig": {
29
30
  "access": "public"