lace-mcp 0.0.2-alpha.2 → 0.0.2-alpha.20

package/README.md

@@ -5,7 +5,7 @@ MCP server for [Lace](https://inlace.co). Connects your coding agent to approved
 ## How it works
 
 1. You review your product in Lace and approve a decision on the [Decision Canvas](https://docs.inlace.co/concepts/decision-canvas)
-2. Your coding agent calls `list_decisions` to see what's been approved
+2. Your coding agent calls `search_decisions` to find what's been approved
 3. It calls `apply_decision` to get screenshots, element targeting, and step-by-step instructions
 4. The agent writes the code change and you review the diff
 
@@ -28,18 +28,19 @@ The Lace desktop app must be open and signed in for the MCP server to work.
 
 | Tool | Description |
 | --- | --- |
-| `list_decisions` | Returns all approved decisions as a summary list |
-| `get_decision` | Full details for a single decision — card, element targeting, bounding box, screenshots |
-| `apply_decision` | Everything needed to implement a decision: screenshots, targeting, and step-by-step instructions |
+| `search_decisions` | Search and filter resolved decisions with pagination. No params returns the top 20 |
+| `apply_decision` | Implementation kit for a decision: screenshots, targeting, instructions. `include` controls detail level |
+| `list_canvases` | Browse review canvases with page names and decision counts |
+| `list_projects` | Browse projects with thread and canvas counts |
 
-Use `apply_decision` when implementing. Use `get_decision` for browsing.
+Use `search_decisions` to discover, then `apply_decision` to act. Use `list_canvases` and `list_projects` to find IDs for filtering.
 
 ## Usage
 
 Once installed, ask your coding agent:
 
 ```
-"List Lace decisions"
+"Search Lace decisions"
 ```
 
 Or to implement directly:

package/SKILL.md

@@ -9,13 +9,15 @@ Lace surfaces adoption insights as actionable decisions. When a decision is appr
 
 ## Steps
 
-1. Call the `list_decisions` MCP tool to see all approved decisions.
-2. If there is exactly one decision, proceed with it. If there are multiple, ask the user which one to implement.
-3. Call the `apply_decision` MCP tool with the chosen decision ID.
-4. Follow the implementation instructions returned by `apply_decision` exactly — they include screenshots, element targeting, and constraints.
-5. Implement the minimal code change described. Do not refactor or modify anything outside the target element.
+1. Call the `search_decisions` MCP tool with no params to see recently approved decisions, or pass filters such as `query`, `canvasId`, `projectId`, `appName`, or `elementRole` when the user has given scope.
+2. If the workspace has many canvases or projects, call `list_canvases` or `list_projects` first and use the returned IDs/titles to scope `search_decisions`.
+3. If there is exactly one relevant decision, proceed with it. If there are multiple plausible matches, ask the user which one to implement.
+4. Call `apply_decision` with the chosen decision ID.
+5. Use `include: "instructions"` by default. Use `include: "crop"` for a cropped element image, `include: "discussion"` for thread rationale, or `include: "all"` when you need screenshots, cropped image, and rationale together.
+6. Follow the implementation instructions returned by `apply_decision` exactly — they include screenshots, element targeting, and constraints.
+7. Implement the minimal code change described. Do not refactor or modify anything outside the target element.
 
 ## Troubleshooting
 
-- If `list_decisions` returns an authentication error, tell the user to run `npx lace-mcp install <editor>` to re-authenticate.
-- If no decisions are returned, the user may need to approve a decision in the Lace overlay first.
+- If `search_decisions` returns an authentication error, tell the user to run `npx lace-mcp install <editor>` to re-authenticate.
+- If no decisions are returned, the user may need to approve a decision in the Lace overlay first or provide a narrower canvas/project scope.