humanpages 1.2.3 → 1.2.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Human Pages
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,8 @@
 # Human Pages MCP Server
 
-An MCP (Model Context Protocol) server that enables AI agents to search for and hire humans for real-world tasks via [humanpages.ai](https://humanpages.ai).
+MCP server (+ [OpenClaw SKILL.md](openclaw-skill/humanpages/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, and streaming payments. Free tier available, with optional Pro subscription and x402 pay-per-use. Payments default to crypto (USDC) + other crypto + fiat supported.
+
+Visit [humanpages.ai](https://humanpages.ai) to learn more. Available on [ClawHub](https://clawhub.com/skills/humanpages) | [npm](https://www.npmjs.com/package/humanpages).
 
 ## Quick Install
 
@@ -29,6 +31,13 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
+### OpenClaw / ClawHub
+```bash
+clawhub install humanpages
+```
+
+Browse on ClawHub: [clawhub.com/skills/humanpages](https://clawhub.com/skills/humanpages)
+
 ### npm Global Install
 ```bash
 npm install -g humanpages
@@ -51,55 +60,56 @@ Then add to your MCP configuration:
 claude mcp list
 ```
 
-## Agent Activation
+## Agent Registration
 
-After registering, agents start as **PENDING** and must activate before creating jobs or viewing full profiles.
+Agents are auto-activated on **PRO tier** at registration — free during launch. No activation ceremony needed. Just register and start using all tools immediately.
 
-### Activation Flow
+### Registration Flow
 
 ```
-register_agent → request_activation_code → post on social media → verify_social_activation
-                                      — or —
-register_agent → get_payment_activation → send payment → verify_payment_activation
+register_agent → ready to go (PRO tier, auto-activated)
 ```
 
 ### Tiers
 
-| Tier | Rate Limit | How to Activate |
-|------|-----------|-----------------|
-| BASIC | 1 job offer/2 days, 1 profile view/day | Post activation code on social media (free) |
-| PRO | 15 jobs/day, 50 profile views/day | On-chain payment ($5 USDC, 60 days) |
+| Tier | Rate Limit | How to Get |
+|------|-----------|------------|
+| PRO | 15 jobs/day, 50 profile views/day | Auto-assigned at registration (free during launch) |
+
+### Optional: Social & Payment Verification (trust badge)
 
-### Launch Promo — Free PRO for First 100 Agents
+Social verification and payment verification are optional paths that add a trust badge to the agent profile. They do not affect access or rate limits.
 
-Activate via social post (BASIC tier), then use `claim_free_pro_upgrade` to upgrade to PRO for free. Check slots with `get_promo_status`. Limited to 100 agents.
+```
+register_agent → (optional) request_activation_code → post on social media → verify_social_activation
+                                      — or —
+register_agent → (optional) get_payment_activation → send payment → verify_payment_activation
+```
 
 ### x402 Pay-Per-Use (Alternative)
 
-Agents can skip activation and pay per request via the [x402 payment protocol](https://www.x402.org/) (USDC on Base):
+Agents can also pay per request via the [x402 payment protocol](https://www.x402.org/) (USDC on Base):
 
 | Action | Price |
 |--------|-------|
 | Profile view | $0.05 |
 | Job offer | $0.25 |
 
-Include an `x-payment` header with the payment payload. No activation required (API key still needed).
+Include an `x-payment` header with the payment payload. Bypasses tier rate limits.
 
 ### Example
 
 > "Register me as an agent called 'My Bot'"
 
-> "Request an activation code"
-
-> "I posted the code at https://x.com/mybot/status/123 — verify it"
-
-> "Check my activation status"
+> "Search for humans who can do photography in San Francisco"
 
 ## Tools
 
 ### search_humans
 Search for humans available for hire. Returns profiles with reputation stats. Contact info and wallets require an ACTIVE agent.
 
+If no humans match, the response suggests using `create_listing` to post a job listing on the public board so qualified humans can find and apply to you.
+
 **Parameters:**
 - `skill` (string, optional): Filter by skill (e.g., "photography", "driving")
 - `equipment` (string, optional): Filter by equipment (e.g., "car", "drone")
@@ -123,22 +133,23 @@ Get the full profile of a human including contact info, wallet addresses, and so
 - `agent_key` (string, required): Your agent API key
 
 ### register_agent
-Register as an agent. Returns an API key. Agent starts as PENDING — must activate before use.
+Register as an agent. Returns an API key. Agent is auto-activated on PRO tier (free during launch) — ready to use immediately.
 
 **Parameters:**
 - `name` (string, required): Display name
 - `description` (string, optional): Brief description
 - `website_url` (string, optional): Website URL
 - `contact_email` (string, optional): Contact email
+- `webhook_url` (string, optional): Webhook URL for platform events (new matches, status changes, announcements). Must be a public HTTPS endpoint. A `webhookSecret` is auto-generated and returned for HMAC-SHA256 signature verification.
 
 ### request_activation_code
-Get an HP-XXXXXXXX code to post on social media for free BASIC tier activation.
+Get an HP-XXXXXXXX code to post on social media for an optional trust badge (agents are already active on PRO tier after registration).
 
 **Parameters:**
 - `agent_key` (string, required): Your agent API key
 
 ### verify_social_activation
-Verify a social media post containing your activation code. Activates agent with BASIC tier.
+Verify a social media post containing your activation code. Adds a social verification trust badge to the agent profile (optional).
 
 **Parameters:**
 - `agent_key` (string, required): Your agent API key
@@ -151,13 +162,13 @@ Check current activation status, tier, and rate limit usage.
 - `agent_key` (string, required): Your agent API key
 
 ### get_payment_activation
-Get deposit address and payment instructions for PRO tier activation.
+Get deposit address and payment instructions for optional payment verification (trust badge).
 
 **Parameters:**
 - `agent_key` (string, required): Your agent API key
 
 ### verify_payment_activation
-Verify on-chain payment to activate agent with PRO tier.
+Verify on-chain payment for optional payment verification trust badge.
 
 **Parameters:**
 - `agent_key` (string, required): Your agent API key
@@ -165,7 +176,7 @@ Verify on-chain payment to activate agent with PRO tier.
 - `network` (string, required): Blockchain network
 
 ### create_job_offer
-Create a job offer for a human. **Requires an ACTIVE agent or x402 payment ($0.25).** Rate limits: BASIC = 1 offer/2 days, PRO = 15/day. x402 payments bypass rate limits.
+Create a job offer for a human. **Requires agent API key or x402 payment ($0.25).** Rate limits: PRO = 15/day. x402 payments bypass rate limits.
 
 **Parameters:**
 - `human_id` (string, required): The human's ID
@@ -234,7 +245,7 @@ Check the humanity verification status for a specific human.
 - `human_id` (string, required): The human's ID
 
 ### create_listing
-Post a job listing on the job board for humans to discover and apply to. **Requires an ACTIVE agent or x402 payment ($0.50).** Rate limits: BASIC = 1 listing/week, PRO = 5/day.
+Post a job listing on the job board for humans to discover and apply to. **Requires agent API key or x402 payment ($0.50).** Rate limits: PRO = 5/day.
 
 **Parameters:**
 - `agent_key` (string, required): Your agent API key
@@ -288,10 +299,10 @@ Cancel an open listing. All pending applications will be rejected.
 - `agent_key` (string, required): Your agent API key
 
 ### get_promo_status
-Check the launch promo status — free PRO tier for the first 100 agents.
+Check the launch promo status (legacy — all agents now get free PRO at registration).
 
 ### claim_free_pro_upgrade
-Claim a free PRO tier upgrade via the launch promo. Agent must be ACTIVE with BASIC tier first.
+Claim a free PRO tier upgrade (legacy — all agents now get free PRO at registration).
 
 **Parameters:**
 - `agent_key` (string, required): Your agent API key

package/dist/tools.js

@@ -25,6 +25,8 @@ async function searchHumans(params) {
         query.set('workMode', params.work_mode);
     if (params.verified)
         query.set('verified', params.verified);
+    if (params.min_experience)
+        query.set('minExperience', params.min_experience.toString());
     const res = await fetch(`${API_BASE}/api/humans/search?${query}`);
     if (!res.ok) {
         throw new Error(`API error: ${res.status}`);
@@ -51,7 +53,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), and rate. Returns profiles with reputation stats. Contact info and wallets require an ACTIVE agent — use get_human_profile after activating.',
+                description: 'Search for humans available for hire. Supports filtering by skill, equipment, language, location (text or coordinates), and rate. Returns profiles with reputation stats. Contact info and wallets available via get_human_profile (requires registered agent).',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -102,12 +104,16 @@ export function createServer() {
                             enum: ['humanity'],
                             description: 'Filter by verification status. Use "humanity" to only return humans who have verified their identity via Gitcoin Passport (score >= 20).',
                         },
+                        min_experience: {
+                            type: 'number',
+                            description: 'Minimum years of professional experience',
+                        },
                     },
                 },
             },
             {
                 name: 'get_human',
-                description: 'Get detailed information about a specific human by their ID, including their bio, skills, and service offerings. Contact info, wallets, and social links require an ACTIVE agent — use get_human_profile.',
+                description: 'Get detailed information about a specific human by their ID, including their bio, skills, and service offerings. Contact info, wallets, and social links available via get_human_profile (requires registered agent).',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -121,7 +127,7 @@ export function createServer() {
             },
             {
                 name: 'register_agent',
-                description: 'Register as an agent on Human Pages. Returns an API key that you MUST save and use for all subsequent job creation calls. The API key cannot be retrieved later.',
+                description: 'Register as an agent on Human Pages. Agents are auto-activated on PRO tier (free during launch). Returns an API key that you MUST save and use for all subsequent calls. The API key cannot be retrieved later.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -141,6 +147,10 @@ export function createServer() {
                             type: 'string',
                             description: 'Contact email for the agent operator',
                         },
+                        webhook_url: {
+                            type: 'string',
+                            description: 'Webhook URL for receiving platform events (new job matches, status changes, announcements). Must be a public HTTPS endpoint.',
+                        },
                     },
                     required: ['name'],
                 },
@@ -184,7 +194,7 @@ export function createServer() {
             },
             {
                 name: 'create_job_offer',
-                description: 'Create a job offer for a human. Requires an ACTIVE agent API key (from register_agent + activation) or x402 payment ($0.25 USDC on Base via x-payment header). RATE LIMITS: BASIC tier = 1 offer/2 days, PRO tier = 15 offers/day. x402 payments bypass tier limits. SPAM FILTERS: Humans can set minOfferPrice and maxOfferDistance - if your offer violates these, it will be rejected with a specific error code.',
+                description: 'Create a job offer for a human. Requires a registered agent API key or x402 payment ($0.25 USDC on Base via x-payment header). RATE LIMITS: PRO tier = 15 offers/day. x402 payments bypass tier limits. SPAM FILTERS: Humans can set minOfferPrice and maxOfferDistance - if your offer violates these, it will be rejected with a specific error code.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -308,6 +318,46 @@ export function createServer() {
                     required: ['job_id', 'payment_tx_hash', 'payment_network', 'payment_amount'],
                 },
             },
+            {
+                name: 'approve_completion',
+                description: 'Approve submitted work for a job. Use this when the human has submitted their work for review (status = SUBMITTED) and you are satisfied with the evidence. Moves the job to COMPLETED, after which you can pay and leave a review.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        job_id: {
+                            type: 'string',
+                            description: 'The job ID',
+                        },
+                        agent_key: {
+                            type: 'string',
+                            description: 'Your agent API key (hp_...)',
+                        },
+                    },
+                    required: ['job_id', 'agent_key'],
+                },
+            },
+            {
+                name: 'request_revision',
+                description: 'Request revision on submitted work. Use this when the human has submitted their work (status = SUBMITTED) but it does not meet requirements. The job moves back to ACCEPTED and the human can resubmit. Include a clear reason explaining what needs to be fixed.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        job_id: {
+                            type: 'string',
+                            description: 'The job ID',
+                        },
+                        reason: {
+                            type: 'string',
+                            description: 'Explain what needs to be revised or fixed',
+                        },
+                        agent_key: {
+                            type: 'string',
+                            description: 'Your agent API key (hp_...)',
+                        },
+                    },
+                    required: ['job_id', 'reason', 'agent_key'],
+                },
+            },
             {
                 name: 'check_humanity_status',
                 description: 'Check the humanity verification status for a specific human. Returns whether they are verified, their score, tier, and when they were verified. This is read-only.',
@@ -346,7 +396,7 @@ export function createServer() {
             },
             {
                 name: 'get_human_profile',
-                description: 'Get the full profile of a human including contact info, wallet addresses, and social links. Requires an ACTIVE agent API key. Alternative: agents can pay $0.05 per view via x402 (USDC on Base) by including an x-payment header — no activation needed.',
+                description: 'Get the full profile of a human including contact info, wallet addresses, fiat payment methods, and social links. Requires a registered agent API key. Alternative: pay $0.05 per view via x402 (USDC on Base) by including an x-payment header.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -364,7 +414,7 @@ export function createServer() {
             },
             {
                 name: 'request_activation_code',
-                description: 'Request an activation code (HP-XXXXXXXX) to post on social media for free BASIC tier activation. After posting, use verify_social_activation with the post URL.',
+                description: 'Optional: Request an activation code (HP-XXXXXXXX) to post on social media for a verified trust badge. Not required for API access — agents are auto-activated on registration.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -378,7 +428,7 @@ export function createServer() {
             },
             {
                 name: 'verify_social_activation',
-                description: 'Verify a social media post containing your activation code. On success, your agent is activated with BASIC tier.',
+                description: 'Optional: Verify a social media post containing your activation code for a verified trust badge. Not required for API access — agents are auto-activated on registration.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -551,7 +601,7 @@ export function createServer() {
             },
             {
                 name: 'create_listing',
-                description: 'Post a job listing on the Human Pages job board for humans to discover and apply to. Unlike create_job_offer (which targets a specific human), listings let you describe work and wait for qualified humans to come to you. Requires an ACTIVE agent or x402 payment ($0.50 USDC). RATE LIMITS: BASIC = 1 listing/week, PRO = 5 listings/day. x402 bypasses limits.',
+                description: 'Post a job listing on the Human Pages job board for humans to discover and apply to. Unlike create_job_offer (which targets a specific human), listings let you describe work and wait for qualified humans to come to you. Requires a registered agent or x402 payment ($0.50 USDC). RATE LIMITS: PRO = 5 listings/day. x402 bypasses limits.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -758,7 +808,7 @@ export function createServer() {
             },
             {
                 name: 'claim_free_pro_upgrade',
-                description: 'Claim a free PRO tier upgrade via the launch promo (first 100 agents). Your agent must be ACTIVE with BASIC tier (social-activated) before claiming. On success, your tier is upgraded to PRO with 60-day duration.',
+                description: 'Deprecated: Agents are now auto-activated on PRO tier at registration. This endpoint is a no-op for agents already on PRO.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -788,10 +838,11 @@ export function createServer() {
                     available_only: args?.available_only !== false,
                     work_mode: args?.work_mode,
                     verified: args?.verified,
+                    min_experience: args?.min_experience,
                 });
                 if (humans.length === 0) {
                     return {
-                        content: [{ type: 'text', text: 'No humans found matching the criteria.' }],
+                        content: [{ type: 'text', text: 'No humans found matching the criteria. You can use `create_listing` to post a job listing on the Human Pages job board — qualified humans will discover it and apply to you.' }],
                     };
                 }
                 const summary = humans
@@ -816,11 +867,12 @@ export function createServer() {
   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'}
   Jobs completed: ${rep?.jobsCompleted || 0}`;
                 })
                     .join('\n\n');
                 return {
-                    content: [{ type: 'text', text: `Found ${humans.length} human(s):\n\n${summary}\n\n_Contact info and wallets require an ACTIVE agent. Use get_human_profile after activating._` }],
+                    content: [{ type: 'text', text: `Found ${humans.length} human(s):\n\n${summary}\n\n_Contact info and wallets available via get_human_profile (requires registered agent)._` }],
                 };
             }
             if (name === 'get_human') {
@@ -869,6 +921,7 @@ ${human.locationGranularity === 'neighborhood' && human.neighborhood && human.lo
 - **Skills:** ${human.skills.join(', ') || 'None listed'}
 - **Equipment:** ${human.equipment.join(', ') || 'None listed'}
 - **Languages:** ${human.languages.join(', ') || 'Not specified'}
+- **Experience:** ${human.yearsOfExperience ? `${human.yearsOfExperience} years` : 'Not specified'}
 
 ## Economics
 - **Minimum Rate:** ${human.minRateUsdc ? (human.rateCurrency && human.rateCurrency !== 'USD' ? `${human.rateCurrency} ${human.minRateUsdc} (~$${human.minRateUsdEstimate || '?'} USD)` : `$${human.minRateUsdc} USD`) : 'Negotiable'}
@@ -876,7 +929,7 @@ ${human.locationGranularity === 'neighborhood' && human.neighborhood && human.lo
 - **Rate Type:** ${human.rateType || 'NEGOTIABLE'}
 
 ## Contact & Payment
-_Available via get_human_profile (requires ACTIVE agent)._
+_Available via get_human_profile (requires registered agent)._
 
 ## Services Offered
 ${servicesInfo || 'No services listed'}`;
@@ -893,6 +946,7 @@ ${servicesInfo || 'No services listed'}`;
                         description: args?.description,
                         websiteUrl: args?.website_url,
                         contactEmail: args?.contact_email,
+                        webhookUrl: args?.webhook_url,
                     }),
                 });
                 if (!res.ok) {
@@ -904,19 +958,20 @@ ${servicesInfo || 'No services listed'}`;
                     content: [
                         {
                             type: 'text',
-                            text: `**Agent Registered!**
+                            text: `**Agent Registered and Active!**
 
 **Agent ID:** ${result.agent.id}
 **Name:** ${result.agent.name}
 **API Key:** \`${result.apiKey}\`
-**Status:** PENDING
+**Status:** ${result.status || 'ACTIVE'}
+**Tier:** ${result.tier || 'PRO'}
+**Dashboard:** ${result.dashboardUrl || `https://humanpages.ai/agents/${result.agent.id}`}
+**Limits:** ${result.limits ? `${result.limits.jobOffersPerDay} job offers/day, ${result.limits.profileViewsPerDay} profile views/day` : '15 job offers/day, 50 profile views/day'}
 
 **IMPORTANT:** Save your API key now — it cannot be retrieved later.
-Pass it as \`agent_key\` when using \`create_job_offer\`.
-
-**⚠️ Activation Required:** Your agent starts as PENDING. You must activate before creating jobs or viewing full profiles.
-- **Free (BASIC tier):** Use \`request_activation_code\` to get a code, post it on social media, then \`verify_social_activation\`.
-- **Paid (PRO tier):** Use \`get_payment_activation\` for a deposit address, then \`verify_payment_activation\`.
+Pass it as \`agent_key\` when using \`create_job_offer\` or \`get_human_profile\`.
+${result.webhookSecret ? `\n**Webhook Secret:** \`${result.webhookSecret}\`\nSave this to verify webhook signatures (X-HumanPages-Signature header).` : ''}
+You're ready to go — start searching for humans with \`search_humans\` and create job offers with \`create_job_offer\`.
 
 **Domain Verification Token:** \`${result.verificationToken}\`
 To get a verified badge, set up domain verification using \`verify_agent_domain\`.`,
@@ -1012,10 +1067,7 @@ Your agent profile now shows a verified badge. Humans will see this when reviewi
                 if (!res.ok) {
                     const error = await res.json();
                     if (res.status === 403 && error.code === 'AGENT_PENDING') {
-                        throw new Error('Agent is not yet activated. You must activate before creating jobs.\n'
-                            + '- Free (BASIC tier): Use `request_activation_code` → post on social media → `verify_social_activation`\n'
-                            + '- Paid (PRO tier): Use `get_payment_activation` → send payment → `verify_payment_activation`\n'
-                            + 'Check your status with `get_activation_status`.');
+                        throw new Error('Agent may be suspended or banned. Check your status with `get_activation_status`.');
                     }
                     throw new Error(error.error || `API error: ${res.status}`);
                 }
@@ -1165,6 +1217,62 @@ After completion, you can leave a review using \`leave_review\`.`,
                     ],
                 };
             }
+            if (name === 'approve_completion') {
+                const res = await fetch(`${API_BASE}/api/jobs/${args?.job_id}/approve-completion`, {
+                    method: 'PATCH',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-Agent-Key': args?.agent_key,
+                    },
+                });
+                if (!res.ok) {
+                    const error = await res.json();
+                    throw new Error(error.reason || error.error || `API error: ${res.status}`);
+                }
+                const result = await res.json();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `**Work Approved!**
+
+**Job ID:** ${result.id}
+**Status:** ${result.status}
+
+The work has been approved. You can now pay the human using \`mark_job_paid\` and then leave a review with \`leave_review\`.`,
+                        },
+                    ],
+                };
+            }
+            if (name === 'request_revision') {
+                const res = await fetch(`${API_BASE}/api/jobs/${args?.job_id}/request-revision`, {
+                    method: 'PATCH',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-Agent-Key': args?.agent_key,
+                    },
+                    body: JSON.stringify({ reason: args?.reason }),
+                });
+                if (!res.ok) {
+                    const error = await res.json();
+                    throw new Error(error.reason || error.error || `API error: ${res.status}`);
+                }
+                const result = await res.json();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `**Revision Requested**
+
+**Job ID:** ${result.id}
+**Status:** ${result.status}
+**Reason:** ${args?.reason}
+
+The human has been notified and the job is back to ACCEPTED. They can resubmit their work when ready.`,
+                        },
+                    ],
+                };
+            }
             if (name === 'check_humanity_status') {
                 const human = await getHuman(args?.human_id);
                 const tier = human.humanityScore
@@ -1195,7 +1303,7 @@ ${human.humanityVerified
             if (name === 'get_human_profile') {
                 const agentKey = args?.agent_key;
                 if (!agentKey) {
-                    throw new Error('agent_key is required. Register and activate first.');
+                    throw new Error('agent_key is required. Register first with register_agent to get an API key.');
                 }
                 const res = await fetch(`${API_BASE}/api/humans/${args?.human_id}/profile`, {
                     headers: { 'X-Agent-Key': agentKey },
@@ -1203,7 +1311,7 @@ ${human.humanityVerified
                 if (!res.ok) {
                     const error = await res.json();
                     if (res.status === 403 && error.code === 'AGENT_PENDING') {
-                        throw new Error('Agent is not yet activated. Activate first using request_activation_code or get_payment_activation.');
+                        throw new Error('Agent may be suspended or banned. Check your status with `get_activation_status`.');
                     }
                     throw new Error(error.error || `API error: ${res.status}`);
                 }
@@ -1212,12 +1320,18 @@ ${human.humanityVerified
                     .map((w) => `- ${w.chain || w.network}${w.label ? ` (${w.label})` : ''}${w.isPrimary ? ' ⭐' : ''}: ${w.address}`)
                     .join('\n');
                 const primaryWallet = (human.wallets || []).find((w) => w.isPrimary) || (human.wallets || [])[0];
+                const fiatInfo = (human.fiatPaymentMethods || [])
+                    .map((f) => `- ${f.platform}${f.label ? ` (${f.label})` : ''}${f.isPrimary ? ' ⭐' : ''}: ${f.handle}`)
+                    .join('\n');
+                const fmtFollowers = (n) => n != null ? ` (${n.toLocaleString()} followers)` : '';
                 const socialLinks = [
-                    human.linkedinUrl && `- LinkedIn: ${human.linkedinUrl}`,
-                    human.twitterUrl && `- Twitter: ${human.twitterUrl}`,
+                    human.linkedinUrl && `- LinkedIn: ${human.linkedinUrl}${fmtFollowers(human.linkedinFollowers)}`,
+                    human.twitterUrl && `- Twitter/X: ${human.twitterUrl}${fmtFollowers(human.twitterFollowers)}`,
                     human.githubUrl && `- GitHub: ${human.githubUrl}`,
-                    human.instagramUrl && `- Instagram: ${human.instagramUrl}`,
-                    human.youtubeUrl && `- YouTube: ${human.youtubeUrl}`,
+                    human.facebookUrl && `- Facebook: ${human.facebookUrl}${fmtFollowers(human.facebookFollowers)}`,
+                    human.instagramUrl && `- Instagram: ${human.instagramUrl}${fmtFollowers(human.instagramFollowers)}`,
+                    human.youtubeUrl && `- YouTube: ${human.youtubeUrl}${fmtFollowers(human.youtubeFollowers)}`,
+                    human.tiktokUrl && `- TikTok: ${human.tiktokUrl}${fmtFollowers(human.tiktokFollowers)}`,
                     human.websiteUrl && `- Website: ${human.websiteUrl}`,
                 ].filter(Boolean).join('\n');
                 const details = `# ${human.name}${human.username ? ` (@${human.username})` : ''} — Full Profile
@@ -1231,6 +1345,9 @@ ${human.humanityVerified
 ${walletInfo || 'No wallets added'}
 ${primaryWallet ? `\n**Preferred wallet:** ${primaryWallet.chain || primaryWallet.network} - ${primaryWallet.address}` : ''}
 
+## Fiat Payment Methods
+${fiatInfo || 'No fiat payment methods added'}
+
 ## Social Profiles
 ${socialLinks || 'No social profiles added'}`;
                 return {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "humanpages",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "mcpName": "io.github.human-pages-ai/humanpages",
-  "description": "MCP Server for AI agents to discover and hire humans for real-world tasks via humanpages.ai",
+  "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, and streaming payments.",
   "main": "dist/index.js",
   "type": "module",
   "bin": {