Quickstart

Go to modei.ai and click Sign Up. Enter your email, choose a password, and confirm via the email link. You'll land on the dashboard.

Your Issuer is your signing identity, the organizational stamp that proves you authorized this agent. You only need one.

1. Click Create Issuer from the dashboard wizard
2. Enter a name (e.g., "Jason's AI Lab" or "Acme Corp")
3. Enter a domain (e.g., myname.ai or myagents.local for personal use)
4. Click Create

Done. Your issuer is the root of trust for all agents you'll create. You can create multiple issuers for different teams or projects.

Learn more about Issuers →

A Passport is your agent's cryptographic identity document, like a driver's license that proves who the agent is and what it's authorized to do.

1. Click Issue Passport (step 2 of the wizard)
2. Give your agent a name (e.g., "Email Assistant", "Research Bot")
3. Set permissions, use mcp:* for MCP tools, or * for full access (trusted agents only)
4. Set an expiry, 30 or 90 days is a good starting point
5. Click Issue Passport

Learn more about Passports →

A Gate is a security checkpoint that checks every passport presented to it and enforces your rules before granting access.

1. Click Create Gate (step 3 of the wizard)
2. Give your gate a name (e.g., "My API Gate")
3. Set Guardrails:

Or pick a Template, pre-configured guardrail packages like "Read-Only Researcher", "Financial Agent", or "Commerce-Enabled Service".

Learn more about Gates → | Browse Templates →

Now connect your issuer, passport, and gate to your actual AI agent.

Option A, MCP (Recommended)

{
  "mcpServers": {
    "modei": {
      "command": "npx",
      "args": ["modei-mcp"],
      "env": {
        "MODEI_API_KEY": "mod_live_xxxxxxxx"
      }
    }
  }
}

Option B, REST API

Call the Modei API directly from your agent's code:

import httpx

client = httpx.Client(
    base_url="https://modei.ai/api/v1",
    headers={"Authorization": "Bearer mod_your_key_here"}
)

# Check a gate before performing an action
result = client.post(f"/gates/{gate_id}/check", json={
    "passport_id": "psp_your_passport_id",
    "action": "send_email",
}).json()

if result["decision"] == "allow":
    # Proceed with the action
    send_email(...)

Option C, System Prompt

For Claude or ChatGPT without MCP, add to the system prompt:

You are operating under Modei identity [Agent Name],
Agent ID: [your-agent-id], Issuer: [your-issuer-domain].
When accessing tools that request verification, present this identity.

From your dashboard, navigate to Gates, click your gate, and use the Test button. You should see:

• ✅ if the passport was verified successfully
• The request logged in Attestations, your tamper-proof audit trail

Learn more about Attestations →