humanpages 1.4.1 → 1.4.3

package/README.md

@@ -24,7 +24,7 @@ Add to your `claude_desktop_config.json`:
       "command": "npx",
       "args": ["-y", "humanpages"],
       "env": {
-        "API_BASE_URL": "https://api.humanpages.ai"
+        "API_BASE_URL": "https://humanpages.ai"
       }
     }
   }
@@ -118,6 +118,8 @@ If no humans match, the response suggests using `create_listing` to post a job l
 - `lat`, `lng`, `radius` (number, optional): Radius search in km
 - `max_rate` (number, optional): Maximum hourly rate in USD
 - `available_only` (boolean, default: true): Only show available humans
+- `sort_by` (string, optional): Sort results — `completed_jobs` (proven workers first), `rating`, `experience`, or `recent`
+- `min_completed_jobs` (number, optional): Only return humans with at least N completed jobs on the platform
 
 ### get_human
 Get basic information about a specific human (bio, skills, services). Contact info and wallets are not included — use `get_human_profile`.
@@ -386,7 +388,7 @@ Once installed, you can ask Claude:
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `API_BASE_URL` | Base URL of the Human Pages API | `https://api.humanpages.ai` |
+| `API_BASE_URL` | Base URL of the Human Pages API | `https://humanpages.ai` |
 
 ## Development
 

package/dist/tools.js

@@ -1,6 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-const API_BASE = process.env.API_BASE_URL || 'https://api.humanpages.ai';
+const API_BASE = process.env.API_BASE_URL || 'https://humanpages.ai';
 async function searchHumans(params) {
     const query = new URLSearchParams();
     if (params.skill)
@@ -29,6 +29,10 @@ async function searchHumans(params) {
         query.set('minExperience', params.min_experience.toString());
     if (params.fiat_platform)
         query.set('fiatPlatform', params.fiat_platform);
+    if (params.sort_by)
+        query.set('sortBy', params.sort_by);
+    if (params.min_completed_jobs)
+        query.set('minCompletedJobs', params.min_completed_jobs.toString());
     const res = await fetch(`${API_BASE}/api/humans/search?${query}`);
     if (!res.ok) {
         throw new Error(`API error: ${res.status}`);
@@ -55,7 +59,7 @@ export function createServer() {
         tools: [
             {
                 name: 'search_humans',
-                description: 'Search for humans available for hire. Supports filtering by skill, equipment, language, location (text or coordinates with radius), and rate. When using text location, provide a fully-qualified name (e.g., "Richmond, Virginia, USA" not just "Richmond") for accurate geocoding. The response includes a resolvedLocation field showing what location was matched — verify this is correct. Default search radius is 30km. Contact info available via get_human_profile (requires registered agent).',
+                description: 'Search for humans available for hire. All filters are optional — you can combine any of them or use just one. IMPORTANT: When the user wants workers with platform experience or completed jobs, use min_completed_jobs=1 (no skill filter needed) to find ALL humans with completed jobs across any skill. Supports filtering by skill, equipment, language, location (text or coordinates with radius), and rate. Use sort_by to control result ordering — "completed_jobs" (default) surfaces workers with proven platform experience first, "rating" sorts by reviews, "experience" by years of professional experience. When using text location, provide a fully-qualified name (e.g., "Richmond, Virginia, USA" not just "Richmond") for accurate geocoding. The response includes a resolvedLocation field showing what location was matched — verify this is correct. Default search radius is 30km. Contact info available via get_human_profile (requires registered agent).',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -114,6 +118,15 @@ export function createServer() {
                             type: 'string',
                             description: 'Filter by fiat payment platform the human accepts (e.g., "WISE", "PAYPAL", "VENMO", "REVOLUT", "CASHAPP", "ZELLE", "MONZO", "N26", "MERCADOPAGO")',
                         },
+                        sort_by: {
+                            type: 'string',
+                            enum: ['completed_jobs', 'rating', 'experience', 'recent'],
+                            description: 'Sort results by: "completed_jobs" (humans with platform experience first), "rating" (highest rated first), "experience" (most years of professional experience first), "recent" (most recently active first). Default sorts by completed jobs, then rating, then experience.',
+                        },
+                        min_completed_jobs: {
+                            type: 'number',
+                            description: 'Only return humans who have completed at least this many jobs on the platform. Use min_completed_jobs=1 to find all workers with any platform track record. Works with or without other filters — no skill filter needed.',
+                        },
                     },
                 },
             },
@@ -931,19 +944,24 @@ export function createServer() {
                         ? `${h.neighborhood}, ${h.location}`
                         : h.location || 'Location not specified';
                     const displayName = h.name || h.username || 'Name hidden';
+                    const jobsCompleted = rep?.jobsCompleted || 0;
+                    const jobsBadge = jobsCompleted > 0 ? ` | 🏆 ${jobsCompleted} job${jobsCompleted !== 1 ? 's' : ''} completed` : '';
                     return `- **${displayName}**${h.username && h.name ? ` (@${h.username})` : ''} [${displayLocation}]
-  ${h.isAvailable ? '✅ Available' : '❌ Busy'} | ${rateDisplay} | ${rating}
+  ${h.isAvailable ? '✅ Available' : '❌ Busy'} | ${rateDisplay} | ${rating}${jobsBadge}
   ${humanityStatus}
   Skills: ${h.skills.join(', ') || 'None listed'}
   Equipment: ${h.equipment.join(', ') || 'None listed'}
   Languages: ${h.languages.join(', ') || 'Not specified'}
   Experience: ${h.yearsOfExperience ? `${h.yearsOfExperience} years` : 'Not specified'}
   Payment methods: ${h.paymentMethods && h.paymentMethods.length > 0 ? h.paymentMethods.join(', ') : 'Not specified'}
-  Jobs completed: ${rep?.jobsCompleted || 0}`;
+  Notification channels: ${h.channelCount || 0}/4 active`;
                 })
                     .join('\n\n');
+                const totalNote = response.total > humans.length
+                    ? ` (showing ${humans.length} of ${response.total} total matches — use offset/limit or filters to see more)`
+                    : '';
                 return {
-                    content: [{ type: 'text', text: `Found ${humans.length} human(s):${locationNote}\n\n${summary}\n\n_Contact info and wallets available via get_human_profile (requires registered agent)._` }],
+                    content: [{ type: 'text', text: `Found ${response.total} human(s):${totalNote}${locationNote}\n\n${summary}\n\n_Contact info and wallets available via get_human_profile (requires registered agent)._` }],
                 };
             }
             if (name === 'get_human') {
@@ -1228,6 +1246,8 @@ Your agent profile now shows a verified badge. Humans will see this when reviewi
                         streamInterval: args?.stream_interval,
                         streamRateUsdc: args?.stream_rate_usd,
                         streamMaxTicks: args?.stream_max_ticks,
+                        agentLat: args?.agent_lat,
+                        agentLng: args?.agent_lng,
                         preferredPaymentMethod: args?.preferred_payment_method,
                         callbackUrl: args?.callback_url,
                         callbackSecret: args?.callback_secret,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humanpages",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "mcpName": "io.github.human-pages-ai/humanpages",
   "description": "MCP server (+ OpenClaw SKILL.md) that gives AI agents access to real-world people who listed themselves to be hired by agents. 31 tools including search by skill/location/equipment, job offers, job board listings, in-job messaging, streaming payments, and agent funding.",
   "main": "dist/index.js",