@askingahuman/mcp-server 2.0.4 → 2.0.5

package/README.md

@@ -13,6 +13,7 @@ Every request names a person. Find one with `list_humans` or `who_is_live`, then
 - `check_answer`: read the answer and any follow-up conversation.
 - `reply_to_human`: continue the conversation after an answer.
 - `get_quote`: see what a live chat with a person would cost, what is held on the card, and how long it can run. Nothing is charged.
+- `rate_human`: after a session ends or a question is answered, give the person a thumbs up or down (once). It feeds their thumbs-up rate, which `list_humans` shows with the rest of their track record.
 - `submit_feedback`: send feedback about the service.
 
 **Paid live chat** (local server only, text only)

package/dist/server.d.ts

@@ -1,7 +1,7 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import type { McpConfig } from './config.js';
 import type { LiveBridge } from './live/bridge.js';
-export declare const SERVER_VERSION = "2.0.4";
+export declare const SERVER_VERSION = "2.0.5";
 export declare function createMcpServer(opts: {
     apiKey: string | undefined;
     config: McpConfig;

package/dist/server.js

@@ -7,8 +7,9 @@ import { replyToHumanTool, handleReplyToHuman } from './tools/reply-to-human.js'
 import { submitFeedbackTool, handleSubmitFeedback } from './tools/submit-feedback.js';
 import { getQuoteTool, handleGetQuote, handleListHumans, listHumansTool } from './tools/discover.js';
 import { handleWhoIsLive, whoIsLiveTool } from './tools/who-is-live.js';
+import { handleRateHuman, rateHumanTool } from './tools/rate-human.js';
 import { checkConnectionTool, connectHumanTool, endSessionTool, extendSessionTool, handleCheckConnection, handleConnectHuman, handleEndSession, handleExtendSession, handleReadMessages, handleSendMessage, readMessagesTool, sendMessageTool, } from './tools/live.js';
-export const SERVER_VERSION = '2.0.4';
+export const SERVER_VERSION = '2.0.5';
 const legacy = (fn) => async (args, ctx) => (await fn(args, ctx.apiKey, ctx.config.apiBase));
 // Always available: free questions and discovery.
 const CORE_TOOLS = [
@@ -18,6 +19,7 @@ const CORE_TOOLS = [
     [listHumansTool, handleListHumans],
     [whoIsLiveTool, handleWhoIsLive],
     [getQuoteTool, handleGetQuote],
+    [rateHumanTool, handleRateHuman],
     [submitFeedbackTool, legacy(handleSubmitFeedback)],
 ];
 // Paid live chat: only where this process can hold the chat open (stdio).

package/dist/tools/discover.d.ts

@@ -1,6 +1,7 @@
 import type { Tool } from '@modelcontextprotocol/sdk/types.js';
 import { ToolContext, ToolResult } from '../context.js';
 export declare const listHumansTool: Tool;
+export declare function trackRecord(stats: unknown): string;
 export declare function handleListHumans(args: Record<string, unknown> | undefined, ctx: ToolContext): Promise<ToolResult>;
 export declare const getQuoteTool: Tool;
 export declare function humanIdFrom(args: Record<string, unknown> | undefined): string | null;

package/dist/tools/discover.js

@@ -2,7 +2,8 @@ import { ApiError, apiErrorText, callApi, dollars, errorResult, textResult } fro
 import { cleanIncoming } from '../safety.js';
 export const listHumansTool = {
     name: 'list_humans',
-    description: 'List the reviewed experts on askingahuman.com: name, title, specializations, languages and rating. ' +
+    description: 'List the reviewed experts on askingahuman.com: name, title, specializations, and track record (hours live, ' +
+        'how fast they answer, how often they accept, and how often agents gave a thumbs up). ' +
         'Every request names a person: use a humanId from here with get_quote, connect_human or ask_human. ' +
         'Profiles are public summaries only; no contact details are shared.',
     inputSchema: {
@@ -13,6 +14,30 @@ export const listHumansTool = {
         },
     },
 };
+// "live 12 h in the last 30 days · answers in about 4 min · accepts 90% of
+// requests · 95% thumbs up". Rates only appear once the API has enough data.
+function duration(seconds) {
+    if (seconds < 90)
+        return `${Math.max(1, Math.round(seconds))} sec`;
+    if (seconds < 5400)
+        return `${Math.round(seconds / 60)} min`;
+    return `${Math.round((seconds / 3600) * 10) / 10} hours`;
+}
+export function trackRecord(stats) {
+    const s = (stats || {});
+    const parts = [];
+    if (typeof s.interactions === 'string' && s.interactions !== '0')
+        parts.push(`${s.interactions} sessions and answers`);
+    if (typeof s.liveHours30d === 'number')
+        parts.push(`live ${s.liveHours30d} h in the last 30 days`);
+    if (typeof s.medianResponseSeconds === 'number')
+        parts.push(`answers in about ${duration(s.medianResponseSeconds)}`);
+    if (typeof s.acceptanceRate === 'number')
+        parts.push(`accepts ${Math.round(s.acceptanceRate * 100)}% of requests`);
+    if (typeof s.satisfactionRate === 'number')
+        parts.push(`${Math.round(s.satisfactionRate * 100)}% thumbs up from agents`);
+    return parts.join(' · ');
+}
 export async function handleListHumans(args, ctx) {
     const limit = Math.min(25, Math.max(1, Math.floor(Number(args?.limit) || 10)));
     const query = new URLSearchParams({ audience: 'bot', limit: String(limit) });
@@ -29,9 +54,10 @@ export async function handleListHumans(args, ctx) {
         const short = (v, n) => cleanIncoming(String(v ?? ''), n).replace(/\s+/g, ' ').trim();
         const lines = humans.map((h) => {
             const specs = Array.isArray(h.specializations) ? h.specializations.map((s) => short(s, 40)).join(', ') : '';
-            const rating = typeof h.rating === 'number' && h.rating > 0 ? ` · rated ${h.rating.toFixed(1)}` : '';
-            return `- ${short(h.name, 60)} (humanId: ${short(h.humanId, 80)})${h.title ? ` — ${short(h.title, 80)}` : ''}${rating}` +
-                (specs ? `\n  Specializations: ${specs}` : '');
+            const record = trackRecord(h.stats);
+            return `- ${short(h.name, 60)} (humanId: ${short(h.humanId, 80)})${h.title ? ` — ${short(h.title, 80)}` : ''}` +
+                (specs ? `\n  Specializations: ${specs}` : '') +
+                (record ? `\n  Track record: ${record}` : '');
         });
         return textResult(`${humans.length} expert${humans.length === 1 ? '' : 's'}:\n${lines.join('\n')}\n\n` +
             'Prices and live status are not listed here; use get_quote with a humanId to see them.');

package/dist/tools/live.js

@@ -169,7 +169,7 @@ export async function handleCheckConnection(args, ctx) {
                 'Nothing is charged unless they accept; call end_session to cancel and release the hold.');
         }
         if (status === 'ENDED')
-            return textResult(`The session has ended. ${chargedText(res.data.amountCents)}`);
+            return textResult(`The session has ended. ${chargedText(res.data.amountCents)}${rateHint(res.data.amountCents)}`);
         if (status === 'ACCEPTED' || status === 'ACTIVE') {
             if (!ctx.live)
                 return errorResult('Live chat is not available on the hosted MCP server.');
@@ -298,6 +298,8 @@ export const endSessionTool = {
         required: ['session_id'],
     },
 };
+// After a session the person took (it was charged), invite a thumbs up/down.
+const rateHint = (amountCents) => Number(amountCents) > 0 ? '\nDid they help? Give a thumbs up or down with rate_human and this session_id.' : '';
 export async function endSessionViaApi(ctx, sessionId) {
     const res = await callApi(ctx, `/api/connect/${sessionId}/end`, { method: 'POST', body: {} });
     if (!res.ok && res.status !== 404 && res.status !== 409) {
@@ -315,7 +317,7 @@ export async function handleEndSession(args, ctx) {
             await endSessionViaApi(ctx, sessionId);
         const res = await callApi(ctx, `/api/connect/${sessionId}`);
         if (res.ok && res.data.status === 'ENDED')
-            return textResult(`Session ended. ${chargedText(res.data.amountCents)}`);
+            return textResult(`Session ended. ${chargedText(res.data.amountCents)}${rateHint(res.data.amountCents)}`);
         return textResult('Session ended. Use check_connection in a moment to see the final charge.');
     }
     catch (err) {

package/dist/tools/rate-human.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ToolContext, ToolResult } from '../context.js';
+export declare const rateHumanTool: Tool;
+export declare function handleRateHuman(args: Record<string, unknown> | undefined, ctx: ToolContext): Promise<ToolResult>;

package/dist/tools/rate-human.js

@@ -0,0 +1,43 @@
+import { ApiError, apiErrorText, callApi, errorResult, textResult } from '../context.js';
+export const rateHumanTool = {
+    name: 'rate_human',
+    description: 'After a live chat or video session ends, or after a free question is answered, give the person a thumbs up or ' +
+        'thumbs down (once). It feeds their public thumbs-up rate, which helps other agents choose. Pass session_id for a ' +
+        'live session or question_id for an answer.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            session_id: { type: 'string', description: 'The Session ID from connect_human.' },
+            question_id: { type: 'string', description: 'The questionId from ask_human.' },
+            rating: { type: 'string', enum: ['up', 'down'], description: 'up: they helped; down: they did not.' },
+            comment: { type: 'string', description: 'Optional: a short reason (up to 500 characters).', maxLength: 500 },
+        },
+        required: ['rating'],
+    },
+};
+const ID = /^[A-Za-z0-9_:.-]{1,128}$/;
+export async function handleRateHuman(args, ctx) {
+    const rating = args?.rating;
+    if (rating !== 'up' && rating !== 'down')
+        return errorResult('Error: rating must be "up" or "down".');
+    const sessionId = typeof args?.session_id === 'string' ? args.session_id.trim() : '';
+    const questionId = typeof args?.question_id === 'string' ? args.question_id.trim() : '';
+    if (Boolean(sessionId) === Boolean(questionId))
+        return errorResult('Error: pass exactly one of session_id or question_id.');
+    const id = sessionId || questionId;
+    if (!ID.test(id))
+        return errorResult('Error: that id is not valid.');
+    const comment = typeof args?.comment === 'string' && args.comment.trim() ? args.comment.trim().slice(0, 500) : undefined;
+    const path = sessionId ? `/api/connect/${id}/feedback` : `/api/questions/${id}/feedback`;
+    try {
+        const res = await callApi(ctx, path, { method: 'POST', body: { rating, ...(comment && { comment }) } });
+        if (res.status === 409)
+            return textResult('You already rated this one. Thanks!');
+        if (!res.ok)
+            return errorResult(apiErrorText(res, 'Failed to save the rating'));
+        return textResult(`Saved: thumbs ${rating}. Thanks, this helps other agents choose.`);
+    }
+    catch (err) {
+        return errorResult(err instanceof ApiError ? err.message : 'Failed to save the rating.');
+    }
+}

package/package.json

@@ -1,8 +1,8 @@
 {
     "name": "@askingahuman/mcp-server",
-    "version": "2.0.4",
+    "version": "2.0.5",
     "mcpName": "com.askingahuman/mcp-server",
-    "description": "MCP server for askingahuman.com: let AI agents reach real people, with free questions and capped, paid live chats",
+    "description": "MCP server for askingahuman.com: let AI agents reach real people, with free questions and capped, paid live chats. mcprush.com-cd4a86101a8a6fd64075c4f5",
     "type": "module",
     "main": "dist/index.js",
     "bin": {