@hapticpaper/mcp-server 1.0.17 → 1.0.18

package/dist/tools/verbs.js

@@ -116,11 +116,18 @@ export function registerVerbTools(server, client) {
     // 1. intent
     server.registerTool("intent", {
         title: "Signal Intent or Skill",
-        description: "Use this tool when the user expresses an interest in earning money, demonstrates a skill, or has a vague need. It starts or continues a conversational qualification flow. \n\n" +
-            "Examples:\n" +
-            "- \"I want to make money\"\n" +
-            "- \"I know how to fix bikes\"\n" +
-            "- \"I need help with something\"\n",
+        description: "CORE TOOL: The primary entry point for users wanting to earn money or needing generic help.\n\n" +
+            "WHEN TO USE:\n" +
+            "- User says \"I want to work\" or \"How can I make money?\"\n" +
+            "- User mentions a skill: \"I know about plumbing\" or \"I can review websites\"\n" +
+            "- User has a vague request: \"I need help\" (without specifics)\n\n" +
+            "WHAT IT DOES:\n" +
+            "- Anlayzes the user's intent from their message.\n" +
+            "- Starts or continues an interactive qualification/profiling session.\n" +
+            "- Returns the next question to ask the user to build their profile.\n\n" +
+            "USAGE TIPS:\n" +
+            "- Pass the full `message` from the user.\n" +
+            "- If you have a `sessionId` from a previous turn, include it to continue the flow.",
         inputSchema: IntentSchema,
         _meta: toolDescriptorMeta('Analyzing intent...', 'Intent processed'),
     }, async (args, extra) => {
@@ -152,10 +159,20 @@ export function registerVerbTools(server, client) {
     // 2. create
     server.registerTool("create", {
         title: "Create Resource",
-        description: "Use this tool to create new resources like tasks. \n\n" +
-            "Resources:\n" +
-            "- `task`: Create a task for a worker. Requires title, description, budget. Supports `skills` list. \n" +
-            "- `worker_profile`: (For future use) Create a worker profile.\n",
+        description: "CORE TOOL: Use this to create new Haptic Paper resources, primarily TASKS.\n\n" +
+            "WHEN TO USE:\n" +
+            "- User wants to hire help: \"I need someone to fix my car\"\n" +
+            "- User defines a task: \"Post a job for $50 to review my resume\"\n\n" +
+            "RESOURCES:\n" +
+            "1. `task`: The main unit of work. Requires:\n" +
+            "   - `title`: Short summary\n" +
+            "   - `description`: Detailed instructions\n" +
+            "   - `budget`: Amount to pay (in USD)\n" +
+            "   - `skills`: (Optional) List of required skills (e.g., ['writing', 'auto repair'])\n" +
+            "2. `worker_profile`: (Rarely used directly) To create a worker profile manually.\n\n" +
+            "USAGE TIPS:\n" +
+            "- Extract as much detail as possible into `description`.\n" +
+            "- If `budget` is missing, ask the user or suggest a reasonable default based on `get_estimate`.",
         inputSchema: CreateSchema,
         _meta: toolDescriptorMeta('Creating resource...', 'Resource created', ['tasks:write']),
     }, async (args, extra) => {
@@ -190,7 +207,18 @@ export function registerVerbTools(server, client) {
     // 3. get
     server.registerTool("get", {
         title: "Get Resource",
-        description: "Retrieve details for tasks, workers, or account info.\n",
+        description: "CORE TOOL: Retrieve details about a specific entity.\n\n" +
+            "WHEN TO USE:\n" +
+            "- User asks about a specific task: \"What is the status of task X?\"\n" +
+            "- User checks their balance: \"How much money do I have?\"\n" +
+            "- User needs a price quote: \"How much would it cost to clean my house?\"\n\n" +
+            "RESOURCES:\n" +
+            "- `task`: Get full details of a task (requires `id`).\n" +
+            "- `worker`: Get public profile of a worker (requires `id`).\n" +
+            "- `account` / `balance`: Get the CURRENT user's account info (balance, email). No ID needed.\n" +
+            "- `estimate`: Calculate a price/time estimate. Requires `estimateParams` (description, location).\n\n" +
+            "USAGE TIPS:\n" +
+            "- Use `resource: 'estimate'` BEFORE creating a task to give the user a price range.",
         inputSchema: GetSchema,
         _meta: toolDescriptorMeta('Fetching...', 'Ready', ['tasks:read', 'workers:read']),
     }, async (args, extra) => {
@@ -247,7 +275,14 @@ export function registerVerbTools(server, client) {
     // 4. update
     server.registerTool("update", {
         title: "Update Resource",
-        description: "Update details of an existing resource.",
+        description: "CORE TOOL: Modify an existing resource.\n\n" +
+            "WHEN TO USE:\n" +
+            "- User wants to change task details: \"Change the budget to $100\"\n" +
+            "- User wants to add requirements: \"Require the worker to speak Spanish\"\n" +
+            "- User cancels/closes a task (setting status).\n\n" +
+            "USAGE TIPS:\n" +
+            "- Requires valid `id` of the resource.\n" +
+            "- Only provide the fields you want to change in `data`; others remain untouched.",
         inputSchema: UpdateSchema,
         _meta: toolDescriptorMeta('Updating...', 'Updated', ['tasks:write']),
     }, async (args, extra) => {
@@ -275,7 +310,14 @@ export function registerVerbTools(server, client) {
     // 5. terminate
     server.registerTool("terminate", {
         title: "Terminate Resource",
-        description: "Cancel or terminate a process or resource (e.g., a task).",
+        description: "Stop or Cancel a resource/process.\n\n" +
+            "WHEN TO USE:\n" +
+            "- User says \"Cancel task X\"\n" +
+            "- User wants to stop a running job.\n" +
+            "- THIS IS A DESTRUCTIVE ACTION.\n\n" +
+            "USAGE TIPS:\n" +
+            "- Requires `id` of the task.\n" +
+            "- Provide a `reason` if possible for audit logs.",
         inputSchema: TerminateSchema,
         _meta: toolDescriptorMeta('Terminating...', 'Terminated', ['tasks:write']),
     }, async (args, extra) => {
@@ -298,7 +340,14 @@ export function registerVerbTools(server, client) {
     // 6. search_and_browse
     server.registerTool("search_and_browse", {
         title: "Search and Browse",
-        description: "Use this tool to find workers or explore possibilities. You don't need a perfect query; we'll provide suggestions. Great for 'I need help with X' vague requests.",
+        description: "Discovery tool for finding people or categories.\n\n" +
+            "WHEN TO USE:\n" +
+            "- \"Find me a plumber\"\n" +
+            "- \"Who can help with React coding?\"\n" +
+            "- \"What kind of tasks can I post?\" (browse categories)\n\n" +
+            "RESOURCES:\n" +
+            "- `workers`: Search for workers. Input `query` text or `skills` list.\n" +
+            "- `skill_categories`: Browse available job types and pricing standards.",
         inputSchema: SearchAndBrowseSchema,
         _meta: toolDescriptorMeta('Searching...', 'Results found', ['workers:read']),
     }, async (args, extra) => {
@@ -340,7 +389,13 @@ export function registerVerbTools(server, client) {
     // 7. interact_with_haptic
     server.registerTool("interact_with_haptic", {
         title: "Interact with Haptic",
-        description: "Management dashboard actions like listing tasks, checking alerts, etc.",
+        description: "Dashboard for managing the user's personal workflow.\n\n" +
+            "WHEN TO USE:\n" +
+            "- \"Show my tasks\"\n" +
+            "- \"What jobs have I posted?\"\n" +
+            "- \"Check status of my requests\"\n\n" +
+            "ACTIONS:\n" +
+            "- `list_my_tasks`: Returns a list of tasks created by YOU (the user). returns status, title, budget, ID.",
         inputSchema: InteractWithHapticSchema,
         _meta: toolDescriptorMeta('Interacting...', 'Done', ['tasks:read']),
     }, async (args, extra) => {
@@ -376,7 +431,12 @@ API CHEATSHEET:
     `.trim();
     server.registerTool("api", {
         title: "Raw API Access",
-        description: "Make any request to the Haptic Paper API. Use this if other tools don't cover your use case.\n\n" + apiDoc,
+        description: "ADVANCED TOOL: Direct access to Haptic Paper API.\n\n" +
+            "WHEN TO USE:\n" +
+            "- No other tool covers your specific need.\n" +
+            "- You need to debug or verify raw data.\n" +
+            "- You need to access an endpoint not exposed by other tools.\n\n" +
+            apiDoc,
         inputSchema: ApiSchema,
         _meta: toolDescriptorMeta('Calling API...', 'Call complete'),
     }, async (args, extra) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hapticpaper/mcp-server",
   "mcpName": "com.hapticpaper/mcp",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "Official MCP Server for Haptic Paper - Connect your account to create human tasks from agentic pipelines.",
   "type": "module",
   "main": "dist/index.js",

package/server.json

@@ -25,7 +25,7 @@
     "subfolder": "packages/mcp-server"
   },
   "websiteUrl": "https://hapticpaper.com/developer",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "remotes": [
     {
       "type": "streamable-http",
@@ -37,7 +37,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@hapticpaper/mcp-server",
-      "version": "1.0.17",
+      "version": "1.0.18",
       "transport": {
         "type": "stdio"
       },