HiveAuth MCP Server

Instructions

Implementation Reference

• src/tools/verifyPresentation.ts:8-86 (handler)

  The main handler function that executes the verify_presentation tool logic. It validates the input presentation, calls the HiveAuth API endpoint to verify it, processes the response, and returns formatted results including status and details.
  export async function verifyPresentation(args: any): Promise<CallToolResult> { // Validate and sanitize input const validation = validateAndSanitizeInput(VerifyPresentationInputSchema, args, 'verify_presentation'); if (!validation.success) { return createValidationErrorResult(validation.error!); } const data = validation.data!; const { presentation } = data; const HIVEAUTH_API_BASE_URL = process.env.HIVEAUTH_API_BASE_URL || 'http://localhost:3000'; const VERIFY_PRESENTATION_ENDPOINT = `${HIVEAUTH_API_BASE_URL}/api/verify-presentation`; try { const response = await fetch(VERIFY_PRESENTATION_ENDPOINT, { method: 'POST', headers: { 'Content-Type': 'application/json', }, body: JSON.stringify({ presentation }), }); if (!response.ok) { const errorData = await response.json().catch(() => ({ message: response.statusText })); throw new Error(`Failed to verify presentation: ${errorData.message}`); } const result = await response.json(); const statusText = result.verified ? '✅ VERIFIED' : '❌ INVALID'; const details = []; if (result.verified) { details.push('• Presentation signature: ✅ Valid'); details.push('• Holder verification: ✅ Valid'); const credentialCount = presentation.verifiableCredential?.length || 0; details.push(`• Credentials verified: ${credentialCount}`); if (result.credentialResults) { result.credentialResults.forEach((credResult: any, index: number) => { const credStatus = credResult.verified ? '✅' : '❌'; details.push(` - Credential ${index + 1}: ${credStatus} ${credResult.verified ? 'Valid' : 'Invalid'}`); }); } } else { details.push(`• Error: ${result.message || 'Unknown verification error'}`); if (result.errors) { result.errors.forEach((error: string) => { details.push(`• ${error}`); }); } } return { content: [ { type: 'text', text: `Presentation Verification Result: ${statusText}\n\n${details.join('\n')}` }, { type: 'text', text: `\`\`\`json\n${JSON.stringify(result, null, 2)}\n\`\`\`` } ] }; } catch (error: any) { return { content: [ { type: 'text', text: `Failed to verify presentation: ${error.message}` } ], isError: true }; } }
• src/schemas/toolSchemas.ts:105-107 (schema)

  Zod input schema definition for the verify_presentation tool, validating the required 'presentation' field using the PresentationSchema.
  export const VerifyPresentationInputSchema = z.object({ presentation: PresentationSchema.describe('The verifiable presentation to verify') });
• src/index.ts:89-90 (registration)

  Registration of the verify_presentation tool in the main MCP server request handler switch statement, dispatching to the verifyPresentation handler function.
  case 'verify_presentation': return await verifyPresentation(args);
• src/utils/schemaConverter.ts:27-29 (registration)

  MCP Tool definition registration in TOOL_DEFINITIONS array, providing name, description, and input schema reference for automatic conversion to MCP tool format via createMCPTools().
  name: 'verify_presentation', description: 'Verify a verifiable presentation containing multiple credentials. Validates presentation signature, holder verification, and all included credentials.', inputSchema: TOOL_SCHEMAS.verify_presentation
• src/schemas/toolSchemas.ts:180-180 (schema)

  Mapping of tool name to its input schema in the TOOL_SCHEMAS constant, used for schema lookup in tool definitions.
  verify_presentation: VerifyPresentationInputSchema,