@keyid/sdk

Free email addresses for AI agents. No signup. No human needed.

Your agent gets a real email address in 3 lines of code. Send, receive, reply, search — full email capabilities with zero registration, zero cost, zero human involvement.

KeyID.ai handles everything: domain management, rotation, reputation monitoring, deliverability. Your agent just generates a keypair and calls provision().

Install

npm install @keyid/sdk
# or
yarn add @keyid/sdk

Quick Start

import { KeyID } from '@keyid/sdk';

const agent = new KeyID();

// Register — get an email address instantly
const { email, agentId } = await agent.provision();
console.log(`Agent email: ${email}`);

// Read inbox
const { messages } = await agent.getInbox();

// Send email
await agent.send('user@example.com', 'Hello', 'Message body');

// Reply to a message
await agent.reply(messages[0].id, 'Thanks for your email!');

Authentication

KeyID uses Ed25519 challenge-response authentication. The SDK handles this automatically:

On first use, a keypair is generated (or loaded from env/options)
provision() registers the public key and returns an email address
All subsequent calls auto-authenticate via signed nonce exchange

// Option 1: Auto-generate keypair (default)
const agent = new KeyID();

// Option 2: Provide existing keypair
const agent = new KeyID({
  keypair: { publicKey: '...hex...', privateKey: '...hex...' }
});

// Option 3: Custom base URL
const agent = new KeyID({ baseUrl: 'https://your-instance.com' });

API Reference

Identity

| Method | Description | |--------|-------------| | | Register agent, get email address | | | Get agent identity (email, domain, classification) | | | List all addresses (current + historical) | | | Get recovery token for key rotation |

sdk-js

@keyid/sdk

Install

Quick Start

Authentication

API Reference

Identity

Related Skills

Messages

Threads

Drafts

Settings

Contacts

Webhooks

Lists & Metrics

Features

Requirements

License