mcp-humanpages

Instructions

Implementation Reference

• src/tools.ts:1679-1731 (handler)

  Handler function that executes the get_activation_status tool. It validates the agent_key parameter, makes an HTTP GET request to the API endpoint /api/agents/activate/status with the agent key in the header, retrieves activation status information including tier, limits, and expiry, and returns a formatted response to the user.

        if (name === 'get_activation_status') {
          const agentKey = args?.agent_key as string;
          if (!agentKey) {
            throw new Error('agent_key is required.');
          }
  
          const res = await fetch(`${API_BASE}/api/agents/activate/status`, {
            headers: { 'X-Agent-Key': agentKey },
          });
  
          if (!res.ok) {
            const error = await res.json() as ApiError;
            throw new Error(error.error || `API error: ${res.status}`);
          }
  
          const result = await res.json() as {
            status: string;
            tier: string;
            activatedAt?: string;
            activationMethod?: string;
            activationExpiresAt?: string;
            limits?: {
              durationDays?: number;
              profileViewsPerDay?: number;
              jobOffersPerDay?: number;
              jobOffersPerTwoDays?: number;
            };
            x402?: { enabled: boolean; prices: { profile_view: string; job_offer: string } };
          };
  
          const limits = result.limits;
          const jobLimit = limits?.jobOffersPerDay
            ? `${limits.jobOffersPerDay}/day`
            : limits?.jobOffersPerTwoDays
              ? `${limits.jobOffersPerTwoDays}/2 days`
              : 'N/A';
  
          return {
            content: [
              {
                type: 'text',
                text: `**Activation Status**
  
  **Status:** ${result.status}
  **Tier:** ${result.tier || 'BASIC'}
  **Activated:** ${result.activatedAt || 'Not yet'}
  **Expires:** ${result.activationExpiresAt || 'N/A'}
  **Profile views:** ${limits?.profileViewsPerDay ?? 'N/A'}/day
  **Job offers:** ${jobLimit}${result.x402?.enabled ? `\n**x402 pay-per-use:** profile view ${result.x402.prices.profile_view}, job offer ${result.x402.prices.job_offer}` : ''}`,
              },
            ],
          };
        }

• src/tools.ts:592-605 (registration)

  Registration of the get_activation_status tool in the ListToolsRequestSchema handler. Defines the tool name, description, and input schema specifying that it requires an agent_key parameter (string) which should be the registered agent's API key.

    name: 'get_activation_status',
    description:
      'Check the current activation status, tier, and expiry for your agent.',
    inputSchema: {
      type: 'object',
      properties: {
        agent_key: {
          type: 'string',
          description: 'Your registered agent API key (starts with hp_)',
        },
      },
      required: ['agent_key'],
    },
  },