check_humanity_status

Verify human verification status by checking their ID, returning verification status, score, tier, and verification date.

Instructions

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`human_id`	Yes	The ID of the human to check

Implementation Reference

src/tools.ts:1491-1518 (handler)

Handler for check_humanity_status tool - fetches human data, calculates verification tier (Gold/Silver/Bronze/None), and returns formatted verification status with score, provider, and timestamp

      if (name === 'check_humanity_status') {
        const human = await getHuman(args?.human_id as string);
        const tier = human.humanityScore
          ? (human.humanityScore >= 40 ? 'Gold' : human.humanityScore >= 20 ? 'Silver' : 'Bronze')
          : 'None';

        return {
          content: [
            {
              type: 'text',
              text: `**Humanity Verification Status**

**Human:** ${human.name}${human.username ? ` (@${human.username})` : ''}
**Verified:** ${human.humanityVerified ? '✅ Yes' : '❌ No'}
**Score:** ${human.humanityScore ?? 'Not checked'}
**Tier:** ${tier}
**Provider:** ${human.humanityProvider || 'N/A'}
**Last Verified:** ${human.humanityVerifiedAt || 'Never'}

${human.humanityVerified
  ? 'This human has verified their identity through Gitcoin Passport.'
  : human.humanityScore
    ? 'This human has checked their score but does not meet the verification threshold (20+).'
    : 'This human has not yet verified their identity.'}`,
            },
          ],
        };
      }

src/tools.ts:501-514 (registration)

Tool registration with name, description, and input schema defining a required human_id parameter

  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.',
  inputSchema: {
    type: 'object',
    properties: {
      human_id: {
        type: 'string',
        description: 'The ID of the human to check',
      },
    },
    required: ['human_id'],
  },
},

src/tools.ts:160-166 (helper)

Helper function that fetches human data from the API endpoint - used by check_humanity_status handler

async function getHuman(id: string): Promise<Human> {
  const res = await fetch(`${API_BASE}/api/humans/${id}`);
  if (!res.ok) {
    throw new Error(`Human not found: ${id}`);
  }
  return res.json() as Promise<Human>;
}

mcp-humanpages