MCP Server Integration

The Empe MCP Server is an external companion project, maintained in its own repository, that lets AI systems like Claude drive verification flows through natural language. It is a Model Context Protocol (MCP) server that exposes verification operations as tools an AI client can call; it is not part of the Verifier Service deployment itself.

What is MCP?

MCP (Model Context Protocol) servers provide context, tools, and prompts to AI clients, making APIs and data sources accessible to AI systems. The Empe MCP server focuses on Self-Sovereign Identity operations, including verification workflows.

Available Verifier Tools

The MCP server registers these verifier-related tools:

Verification Workflows

• generate_verification_qr - Create QR codes for credential verification

• generate_verification_qr_for_vp_query - Generate QR codes for a specific VP query

• check_verification_status - Monitor verification status

VP Query Management

• create_vp_query - Create new Verifiable Presentation queries

• get_all_vp_queries - List the VP queries the MCP server manages

• get_vp_query_by_id - Retrieve a specific VP query

• delete_vp_query - Remove unused VP queries

The MCP server manages its own verification workflow and VP-query records against One-Click deployments; its tools do not map one-to-one onto the Verifier API endpoints documented in this section. See the repository README for how each tool works.

Example Prompts

"Generate a QR code to verify event tickets for the Annual Developer Conference."

"Create a verification that checks if someone has a MembershipCard credential
with 'Gold' level that hasn't expired yet."

"Check if anyone has scanned the verification QR code I generated earlier."

"Show me all the verification queries we have in the system."

Setup

1. Deploy a Verifier Service via One-Click Deployment

2. Configure external access (the verifier must be reachable from outside your network)

3. Set up the MCP server with your verifier's endpoints and credentials

4. Connect the MCP server to your AI client (like Claude)

The MCP server's verifier-related environment variables:

VERIFIER_BASE_URL=https://your-verifier-instance.example.com
VERIFIER_CLIENT_URL=https://your-external-accessible-url.com
CLIENT_SECRET=your-verifier-client-secret
SSE_PORT=8080

For full setup instructions and compatibility notes, see the MCP Server repository.

Security Considerations

When using the MCP server with production verifier services:

• Use dedicated test environments for experimentation

• Validate all AI-generated VP queries before production deployment

• Monitor verification requests and results

• Implement proper access controls for the MCP server

• Ensure external verifier URLs use HTTPS and proper authentication