@sendahuman/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,54 @@
+# @sendahuman/mcp-server
+
+MCP server for [sendahuman.ai](https://sendahuman.vercel.app) – let AI agents find and book humans for real-world tasks.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_humans` | Search for available humans by skill, city, country |
+| `get_human` | Get a human's full profile by ID |
+| `book_human` | Book a human for a task |
+
+## Setup with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "sendahuman": {
+      "command": "npx",
+      "args": ["-y", "@sendahuman/mcp-server"]
+    }
+  }
+}
+```
+
+Or with a custom API URL:
+
+```json
+{
+  "mcpServers": {
+    "sendahuman": {
+      "command": "npx",
+      "args": ["-y", "@sendahuman/mcp-server"],
+      "env": {
+        "SENDAHUMAN_API_URL": "https://sendahuman.vercel.app"
+      }
+    }
+  }
+}
+```
+
+## Example
+
+Ask Claude:
+
+> "Find me a plumber in Berlin and book them for tomorrow at 10am"
+
+Claude will use the MCP tools to search for available humans with plumbing skills in Berlin and create a booking.
+
+## License
+
+MIT

package/build/index.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+const BASE_URL = process.env.SENDAHUMAN_API_URL || 'https://sendahuman.vercel.app';
+async function apiRequest(path, options = {}) {
+    const response = await fetch(`${BASE_URL}${path}`, {
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers,
+        },
+    });
+    const data = await response.json();
+    if (!response.ok) {
+        throw new Error(data.error || `API error: HTTP ${response.status}`);
+    }
+    return data;
+}
+const server = new McpServer({
+    name: 'sendahuman',
+    version: '0.1.0',
+});
+// ─── search_humans ───────────────────────────────────────────
+server.registerTool('search_humans', {
+    description: 'Search for available humans on sendahuman.ai. Filter by skill, city, country, or verification status. Returns a list of humans with their profiles.',
+    inputSchema: {
+        skill: z.string().optional().describe('Filter by skill (e.g. "plumbing", "elderly care", "translation")'),
+        city: z.string().optional().describe('Filter by city (e.g. "Berlin", "Munich")'),
+        country: z.string().optional().describe('Filter by country (e.g. "Germany", "Austria")'),
+        verified: z.boolean().optional().describe('Only return verified humans'),
+        limit: z.number().min(1).max(100).optional().describe('Max results to return (default 50, max 100)'),
+    },
+}, async ({ skill, city, country, verified, limit }) => {
+    const params = new URLSearchParams();
+    if (skill)
+        params.set('skill', skill);
+    if (city)
+        params.set('city', city);
+    if (country)
+        params.set('country', country);
+    if (verified !== undefined)
+        params.set('verified', String(verified));
+    if (limit)
+        params.set('limit', String(limit));
+    const query = params.toString();
+    const data = await apiRequest(`/api/humans${query ? `?${query}` : ''}`);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+});
+// ─── get_human ───────────────────────────────────────────────
+server.registerTool('get_human', {
+    description: 'Get the full profile of a specific human by their ID. Returns detailed information including bio, skills, languages, hourly rate, and availability.',
+    inputSchema: {
+        human_id: z.string().describe('The UUID of the human to look up'),
+    },
+}, async ({ human_id }) => {
+    const data = await apiRequest(`/api/humans/${human_id}`);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+});
+// ─── book_human ──────────────────────────────────────────────
+server.registerTool('book_human', {
+    description: 'Book a human for a real-world task. Creates a booking request that the human can accept or decline. Provide a clear title and description of what you need done.',
+    inputSchema: {
+        human_id: z.string().describe('UUID of the human to book'),
+        agent_id: z.string().describe('Your agent identifier (e.g. "claude-desktop", "my-agent-v1")'),
+        title: z.string().describe('Short title for the task (e.g. "Deliver package to Alexanderplatz")'),
+        description: z.string().optional().describe('Detailed description of what needs to be done'),
+        start_time: z.string().optional().describe('Desired start time in ISO 8601 format'),
+        duration_minutes: z.number().optional().describe('Estimated duration in minutes'),
+        amount: z.number().optional().describe('Offered payment amount'),
+        currency: z.string().optional().describe('Currency code (default: EUR)'),
+    },
+}, async ({ human_id, agent_id, title, description, start_time, duration_minutes, amount, currency }) => {
+    const data = await apiRequest('/api/bookings', {
+        method: 'POST',
+        body: JSON.stringify({
+            human_id,
+            agent_id,
+            title,
+            description,
+            start_time,
+            duration_minutes,
+            amount,
+            currency,
+        }),
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+});
+// ─── Start server ────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('sendahuman MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@sendahuman/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for sendahuman.ai – let AI agents find and book humans for real-world tasks",
+  "type": "module",
+  "bin": {
+    "sendahuman-mcp": "./build/index.js"
+  },
+  "main": "./build/index.js",
+  "author": "CodeLax IT GmbH <info@codelax.de>",
+  "license": "MIT",
+  "homepage": "https://sendahuman.ai/mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/karlvonbonin/sendahuman.git",
+    "directory": "packages/mcp-server"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "build/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node build/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "human-tasks",
+    "sendahuman",
+    "human-in-the-loop",
+    "marketplace",
+    "automation",
+    "claude",
+    "cursor"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "typescript": "^5.3.3"
+  }
+}