humanpages 1.2.2 → 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/http.d.ts

@@ -0,0 +1 @@
+import 'dotenv/config';

package/dist/http.js

@@ -0,0 +1,23 @@
+import 'dotenv/config';
+import express from 'express';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createServer } from './tools.js';
+const app = express();
+app.use(express.json({ limit: '256kb' }));
+// Stateless: fresh server + transport per request
+app.post('/mcp', async (req, res) => {
+    const server = createServer();
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+    res.on('close', () => { transport.close(); server.close(); });
+    await server.connect(transport);
+    await transport.handleRequest(req, res, req.body);
+});
+// Stateless mode — no SSE streams or session cleanup
+app.get('/mcp', (_req, res) => { res.status(405).end(); });
+app.delete('/mcp', (_req, res) => { res.status(405).end(); });
+app.get('/health', (_req, res) => { res.json({ status: 'ok' }); });
+const port = parseInt(process.env.HTTP_PORT || '3002');
+app.listen(port, '127.0.0.1', () => {
+    console.log(`Human Pages MCP HTTP server on port ${port}`);
+});
+//# sourceMappingURL=http.js.map