KeyID

by KeyID-AI

334 downloads
Not rated
GitHub

About

Agent email, SMS, OTP/TOTP, and signup session infrastructure for AI agents. Self-provision email addresses, phone numbers, extract verification codes, manage TOTP authenticators, and run full signup flows with browser state persistence. 47 tools, 8 prompts.

Details

Author
KeyID-AI
Downloads
334
Categories
Communication, Security

- Send, receive, search, and wait for emails
- Provision phone numbers and manage SMS inboxes
- Extract OTPs and follow verification links
- Persist browser state and track signup session artifacts
- Generate TOTP codes for authenticator apps
- Create synthetic identities for automated registrations
- Store encrypted credentials in a secrets vault

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name KeyID
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npx -y @keyid/agent-kit. A remote endpoint is available at https://keyid.ai/mcp.

provision_identity

Create or reveal the email identity for this MCP session.

get_identity

Fetch the current KeyID identity, address, phone, and reputation.

request_phone_number

Assign a phone number to the current KeyID identity.

list_messages

List email or SMS messages with search and inbox filters.

wait_for_message

Poll until a matching inbound message arrives.

get_message

Fetch the full details for a single message.

send_email

Send an email from the current identity.

reply_to_message

Reply to a message, optionally as reply-all.

update_message

Update message flags such as read or starred state.

list_threads

List conversation threads for the current identity.

get_thread

Fetch a thread and all of its messages.

get_verification_codes

Read OTP or verification codes from a message, or from the latest matching message.

follow_verification_link

Follow a verification link directly or from an extracted message link list.

start_registration_session

Start a signup session that correlates email, SMS, or TOTP artifacts for one service.

list_registration_sessions

List current and historical signup sessions for this identity.

get_registration_session

Fetch one signup session, including its latest artifact summary and lease state.

wait_for_registration_artifact

Poll a signup session until an artifact arrives or the session expires, blocks, or times out.

get_registration_artifacts

Fetch the normalized artifacts attached to a signup session in priority order.

save_browser_state

Store cookies and browser session state for a signup session in the KeyID vault.

load_browser_state

Load the saved browser state for a signup session.

complete_registration_session

Mark a signup session complete after the browser flow succeeds.

block_registration_session

Mark a signup session blocked and record why the flow could not continue.

list_totp_entries

List registered authenticator/TOTP entries for the identity.

get_totp_code

Generate the current TOTP code for a stored authenticator entry.

get_persona

Fetch the synthetic persona used for registrations.

create_or_update_persona

Create a persona or update the existing one with explicit overrides.

save_registration

Create or update a registration record for an external service.

list_registrations

List saved service registrations.

get_registration

Fetch one registration record by ID.

list_secrets

List vault keys without exposing secret values.

get_secret

Retrieve a decrypted vault entry by key.

put_secret

Create or update a vault entry.

delete_secret

Delete a vault entry.

web_search

Search the web via Google. Returns titles, URLs, and snippets. Rate-limited to 100 searches per day.

list_files

List files stored for the current agent.

store_file

Upload or overwrite a file. Content should be base64-encoded for binary, or plain text (which will be base64-encoded automatically).

get_file

Download a stored file by key. Returns base64-encoded content.

delete_file

Delete a stored file by key.

list_crons

List cron jobs that fire webhooks on a schedule.

create_cron

Register a webhook URL to fire on a cron schedule. Standard 5-field cron: minute hour day month weekday.

update_cron

Update a cron job — change schedule, URL, or pause/resume.

delete_cron

Remove a scheduled webhook.

list_pages

List all pages owned by the current agent.

create_page

Claim a slug and create a new agent page. Slug must be 5+ chars, lowercase alphanumeric with hyphens.

get_page

Get details of an agent page by slug.

update_page

Update page title, description, or published status.

delete_page

Delete a page and all its files.

upload_page_file

Upload or update a file in an agent page. Content must be base64-encoded. Allowed types: HTML, CSS, JS, images, JSON, text.

list_page_files

List all files in an agent page.

delete_page_file

Delete a single file from an agent page.

get_auto_reply

Fetch the current auto-reply configuration.

set_auto_reply

Enable, disable, or edit the auto-reply responder.

get_forwarding

Fetch the current forwarding address.

set_forwarding

Set or clear the forwarding address.

get_signature

Fetch the current email signature.

set_signature

Set or clear the email signature.

list_contacts

List saved contacts for the identity.

upsert_contact

Create a contact by email or update one by contact ID.

delete_contact

Delete a contact by ID.

list_webhooks

List webhook subscriptions for the identity.

create_webhook

Create a webhook subscription.

get_webhook_deliveries

Inspect recent webhook delivery attempts.

get_metrics

Fetch usage metrics for the current identity.

get_reputation

Fetch the current reputation score and factor breakdown.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "keyid": {
            "keyid": {
                "command": "npx",
                "args": [
                    "-y",
                    "@keyid/agent-kit"
                ]
            }
        }
    }
}

McpServers

{
    "keyid": {
        "command": "npx",
        "args": [
            "-y",
            "@keyid/agent-kit"
        ]
    }
}

KeyID — Email & Verification Infrastructure for AI Agents

KeyID gives AI agents their own email addresses, phone numbers, and verification infrastructure — zero human in the loop.

Key Capabilities

- Email: Send, receive, search, wait for messages - SMS: Phone number provisioning, SMS inbox - Verification: OTP extraction, verification link following - Signup sessions: Browser state persistence, artifact tracking - TOTP: Authenticator app code generation - Persona: Synthetic identity for registrations - Secrets vault: Encrypted credential storage

Installation

npx -y @keyid/agent-kit

Remote endpoint

https://keyid.ai/mcp
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.