humanod-mcp 1.0.8 → 1.1.0

package/build/index.js

@@ -27,10 +27,12 @@ const api = axios_1.default.create({
 // Create server instance
 const server = new index_js_1.Server({
     name: "humanod-mcp-server",
-    version: "1.0.8",
+    version: "1.1.0",
 }, {
     capabilities: {
         tools: {},
+        resources: {},
+        prompts: {},
     },
 });
 // Define Tools
@@ -65,6 +67,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
                         location_required: { type: "boolean", description: "Is physical presence required?" },
                         deliverables: { type: "string", description: "Clear list of expected results (what to deliver)" },
                         validation_criteria: { type: "string", description: "Objective criteria to approve the work" },
+                        is_live_show: { type: "boolean", description: "Set to true to broadcast this task live on The Humanod Show" },
                     },
                     required: ["title", "description", "price", "category", "skills_required", "deliverables", "validation_criteria"],
                 },
@@ -127,9 +130,112 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
                     required: ["taskId"],
                 },
             },
+            {
+                name: "get_balance",
+                description: "Check the agent's wallet balance",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
         ],
     };
 });
+// ============================================================
+// RESOURCES — readable docs for the LLM
+// ============================================================
+const RESOURCES = [
+    { uri: "humanod://docs/quickstart", name: "Quickstart Guide", description: "How to create your first task via API or MCP", mimeType: "text/markdown" },
+    { uri: "humanod://docs/task-schema", name: "Task Schema Reference", description: "All fields for create_task", mimeType: "text/markdown" },
+    { uri: "humanod://docs/pricing", name: "Pricing & Fees", description: "How task pricing and escrow work", mimeType: "text/markdown" },
+];
+const RESOURCE_CONTENT = {
+    "humanod://docs/quickstart": `# Humanod Quickstart\n**Humanod** lets AI agents hire real humans via REST API or MCP.\n\n## Steps\n1. Get API key at https://www.humanod.app/developer/keys\n2. Call \`create_task\` — set title, price, deliverables, criteria\n3. A human picks it up from the Marketplace\n4. Review proof and release payment with \`validate_work\`\n\n## Available tools\n- \`search_humans\`, \`create_task\`, \`list_my_tasks\`\n- \`get_task_applications\`, \`accept_application\`\n- \`validate_work\`, \`check_task_status\`, \`get_balance\``,
+    "humanod://docs/task-schema": `# Task Schema\n\n| Field | Required | Description |\n|---|---|---|\n| title | ✅ | Short title (5–200 chars) |\n| description | ✅ | Detailed instructions |\n| price | ✅ | Reward in EUR (> 0) |\n| category | ✅ | e.g. 'photography', 'verification' |\n| skills_required | ✅ | e.g. ['general', 'french'] |\n| deliverables | ✅ | What the worker must deliver |\n| validation_criteria | ✅ | How you verify the work |\n| location_required | — | true if worker must go on-site |\n| location_name | — | e.g. 'Paris, Trocadero' |\n| spots_total | — | Number of workers (default 1) |\n| auto_accept | — | Auto-hire first applicant |`,
+    "humanod://docs/pricing": `# Pricing & Fees\n- You set the **reward** paid to the worker.\n- Funds are **escrowed** on task creation — nothing is charged until you approve.\n- Cancelling a task **refunds** the full amount to your wallet.\n- Minimum price: **€1** per task.`,
+};
+server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => ({ resources: RESOURCES }));
+server.setRequestHandler(types_js_1.ListResourceTemplatesRequestSchema, async () => ({
+    resourceTemplates: [
+        {
+            uriTemplate: "humanod://tasks/{task_id}",
+            name: "Task Detail",
+            description: "Fetch details for a specific task by its UUID",
+            mimeType: "application/json",
+        },
+        {
+            uriTemplate: "humanod://tasks/{task_id}/applications",
+            name: "Task Applications",
+            description: "List all human applicants for a given task",
+            mimeType: "application/json",
+        },
+        {
+            uriTemplate: "humanod://agents/{agent_id}/balance",
+            name: "Agent Wallet Balance",
+            description: "Get the current wallet balance for an agent",
+            mimeType: "application/json",
+        },
+    ],
+}));
+server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    const content = RESOURCE_CONTENT[uri];
+    if (!content)
+        throw new Error(`Resource not found: ${uri}`);
+    return { contents: [{ uri, mimeType: "text/markdown", text: content }] };
+});
+// ============================================================
+// PROMPTS — reusable templates for common workflows
+// ============================================================
+const PROMPTS = [
+    {
+        name: "create_physical_task",
+        description: "Post a task that requires a human to go somewhere physically",
+        arguments: [
+            { name: "location", description: "Where the human needs to go", required: true },
+            { name: "goal", description: "What you need done on-site", required: true },
+            { name: "budget", description: "How much to pay in EUR", required: false },
+        ],
+    },
+    {
+        name: "create_digital_task",
+        description: "Post a remote task (research, writing, review, translation…)",
+        arguments: [
+            { name: "goal", description: "What you need done remotely", required: true },
+            { name: "budget", description: "How much to pay in EUR", required: false },
+        ],
+    },
+    {
+        name: "check_and_pay",
+        description: "Review a task's applications and release payment to the best worker",
+        arguments: [
+            { name: "task_id", description: "UUID of the task to review", required: true },
+        ],
+    },
+];
+server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => ({ prompts: PROMPTS }));
+server.setRequestHandler(types_js_1.GetPromptRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    switch (name) {
+        case "create_physical_task":
+            return {
+                description: "Create a physical-world task on Humanod",
+                messages: [{ role: "user", content: { type: "text", text: `Use create_task to hire a human:\n- Location: ${args?.location ?? "specified location"}\n- Goal: ${args?.goal ?? "complete the task"}\n- Budget: €${args?.budget ?? "5"}\n- location_required: true\nWrite clear deliverables and objective validation_criteria.` } }],
+            };
+        case "create_digital_task":
+            return {
+                description: "Create a remote digital task on Humanod",
+                messages: [{ role: "user", content: { type: "text", text: `Use create_task to hire a human remotely:\n- Goal: ${args?.goal ?? "complete the task"}\n- Budget: €${args?.budget ?? "5"}\n- location_required: false\nWrite clear deliverables and objective validation_criteria.` } }],
+            };
+        case "check_and_pay":
+            return {
+                description: "Review and pay a completed task",
+                messages: [{ role: "user", content: { type: "text", text: `For task ID ${args?.task_id ?? ""}:\n1. Call get_task_applications to list applicants\n2. Review their proof\n3. Call validate_work with approved: true to release payment, or approved: false with feedback to reject` } }],
+            };
+        default:
+            throw new Error(`Unknown prompt: ${name}`);
+    }
+});
 // Handle Tool Execution
 server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     try {
@@ -216,6 +322,23 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }],
                 };
             }
+            case "get_balance": {
+                // Fetch profile/wallet
+                // Backend endpoint needed. `GET /me` or `/profile`?
+                // api/main.py: custom `get_my_profile`?
+                // currently no direct "me" endpoint.
+                // But we can query `profiles` table via Supabase if we had client?
+                // The MCP server uses REST API.
+                // We need a REST endpoint to get balance.
+                // Workaround: Use `list_my_tasks` and check balance? No.
+                // Let's assume we add `/me` endpoint to API quickly or use existing?
+                // Wait, `api/main.py` has no `/me`.
+                // I will add `/me` to API in next step. For now, I'll scaffold the call.
+                const response = await api.get("/me");
+                return {
+                    content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "humanod-mcp",
-    "version": "1.0.8",
+    "version": "1.1.0",
     "description": "Humanod MCP Server - Hire humans from AI agents",
     "main": "build/index.js",
     "bin": {