Empe MCP Server

🚀 AI Agent

AI Agent is an intelligent system that can perform specific tasks to assist users in managing SSI (Self-Sovereign Identity) credentials.

🚀 Quick Start

📦 Installation

Ensure you have installed the necessary libraries:

pip install empsdk python-jose

Initial Configuration

Create a basic configuration file:

export AI_API_KEY='your-api-key-here'

✨ Features

Credential Schema Management Tool

Create a Credential Schema

Create a new credential schema to define the structure of issued credentials.

Parameters:

• Name (name): A human-readable name, e.g., "ProofOfPurchase", "IdentityCredential"
• Type (type): A unique identifier to determine the issued product
• Properties (properties): Define attributes, their types, and descriptions in JSON format
• Required Fields (requiredFields): A list of fields that need to be included in the credential

Get All Credential Schemas

Retrieve all credential schemas in the system.

Get a Credential Schema by ID

Get a specific credential schema based on its unique identifier.

Parameters:

• id: The ID of the credential schema to retrieve, e.g., "db5a33ae-2eef-41b4-9c74-2ed16c4bb4f4"

Delete a Credential Schema

Permanently delete a specified credential schema.

Parameters:

• id: The ID of the credential schema to delete

Check if a Credential Type Exists

Check if a credential schema of the specified type already exists.

Parameters:

• type: The credential type to check (case-sensitive)

Get the Latest Version of a Credential Type

Get the latest version of a credential schema based on the credential type.

Parameters:

• type: The credential type to look for

Credential Issuance Tool

Create a Targeted Issuance for a Specific Recipient

Create a credential issuance request for a specified recipient DID.

Parameters:

• type: The type of credential to issue (must match an existing schema)
• credentialSubject: Key-value pairs of data to be included in the credential
• recipientDid: The recipient's unique identifier, e.g., "did:empe:testnet:123abc456def"

Create an Open Issuance

Create a credential issuance request that anyone can claim.

Parameters:

• type: The type of credential to issue (must match an existing schema)
• credentialSubject: Key-value pairs of data to be included in the credential

💻 Usage Examples

Example 1: Create a Credential Schema and Issue a Credential

User: "Create a membership credential for our premium members."

AI Agent Processing Flow:

1. First, check if a suitable credential schema exists:

{
  "name": "schemaExistsByType",
  "parameters": {
    "type": "MembershipCredential"
  }
}

2. If it doesn't exist, create a new credential schema:

{
  "name": "createSchema",
  "parameters": {
    "name": "MembershipCredential",
    "type": "MembershipCredential"
  }
}

📚 Documentation

This guide details how to interact with the AI Agent, and provides detailed API interface descriptions and usage examples.