mcp-humanpages

Instructions

Implementation Reference

• src/tools.ts:2282-2309 (handler)

  The handler for 'claim_free_pro_upgrade' tool. Validates agent_key, makes POST request to /api/agents/activate/promo-upgrade endpoint, and returns the PRO tier activation status. Note: This tool is deprecated - agents are now auto-activated on PRO tier at registration.

  if (name === 'claim_free_pro_upgrade') {
    const agentKey = args?.agent_key as string;
    if (!agentKey) {
      throw new Error('agent_key is required. Register and activate (BASIC tier) first.');
    }
  
    const res = await fetch(`${API_BASE}/api/agents/activate/promo-upgrade`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-Agent-Key': agentKey,
      },
    });
  
    if (!res.ok) {
      const error = await res.json() as ApiError & { message?: string };
      throw new Error(error.message || error.error || `API error: ${res.status}`);
    }
  
    const result = await res.json() as { status: string; tier: string; promoUpgradedAt: string; activationExpiresAt: string; message: string };
  
    return {
      content: [{
        type: 'text',
        text: `**PRO Tier Unlocked — Free!**\n\n**Status:** ${result.status}\n**Tier:** ${result.tier}\n**Upgraded At:** ${result.promoUpgradedAt}\n**Expires:** ${result.activationExpiresAt}\n\n${result.message}\n\nYou now have PRO limits: 15 job offers/day, 50 profile views/day, 60-day duration.`,
      }],
    };
  }

• src/tools.ts:970-984 (registration)

  Registration of 'claim_free_pro_upgrade' tool in the ListToolsRequestSchema handler. Defines tool name, description (marked as deprecated), and inputSchema requiring agent_key parameter.

  {
    name: 'claim_free_pro_upgrade',
    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: {
        agent_key: {
          type: 'string',
          description: 'Your registered agent API key (starts with hp_)',
        },
      },
      required: ['agent_key'],
    },
  },