# KeyID.ai

Private infrastructure for AI agent fleets. One project key to email, phone, web search, file storage, page hosting, 2FA, cron, encrypted vault, synthetic personas, and verification handling. 64 MCP tools. Access requires a project key. Plans start at $29/mo and issue a key immediately at https://keyid.ai/#pricing; there is no free tier and no open shared pool.

Remote MCP endpoint:
- https://keyid.ai/mcp

Local MCP package:
- npx -y @keyid/agent-kit

Current package versions from /api/version:
- @keyid/sdk 0.4.3
- @keyid/agent-kit 0.4.1
- keyid 0.4.3

MCP tools (64):
- Identity: provision_identity, get_identity, request_phone_number
- Messages: list_messages, wait_for_message, get_message, send_email, reply_to_message, update_message
- Threads: list_threads, get_thread
- Verification: get_verification_codes, follow_verification_link
- Signup: start_registration_session, list_registration_sessions, get_registration_session, wait_for_registration_artifact, get_registration_artifacts, save_browser_state, load_browser_state, complete_registration_session, block_registration_session
- TOTP: list_totp_entries, get_totp_code
- Persona: get_persona, create_or_update_persona, save_registration, list_registrations, get_registration
- Secrets: list_secrets, get_secret, put_secret, delete_secret
- Search: web_search
- Storage: list_files, store_file, get_file, delete_file
- Scheduling: list_crons, create_cron, update_cron, delete_cron
- Pages: list_pages, create_page, get_page, update_page, delete_page, upload_page_file, list_page_files, delete_page_file
- Settings: get_auto_reply, set_auto_reply, get_forwarding, set_forwarding, get_signature, set_signature
- Contacts: list_contacts, upsert_contact, delete_contact
- Webhooks: list_webhooks, create_webhook, get_webhook_deliveries
- Insights: get_metrics, get_reputation
- Phone & SMS: request_phone_number (persistent number), list_messages with channel=sms, start_registration_session with useSmsLease (leased per-signup), sms.received webhooks

MCP prompts (8):
- set-up-agent-communications: Provision email, inspect identity, and enable the communication settings the user asks for.
- complete-email-verification: Use the low-level verification tools to watch for one verification message and surface the best link or code.
- run-signup-session: Start a signup session, keep browser state aligned, and finish or block the flow with explicit state.
- resume-signup-session: Load saved browser state, continue a paused signup, and wait for the next artifact only if needed.
- fetch-latest-code: Retrieve the newest verification code from email, SMS, or TOTP.
- triage-inbox: List recent messages, highlight urgent items, and suggest the safest next reply action.
- autonomous-signup: Create or update a persona, run a signup session, and record the completed registration with durable state.
- reply-conservatively: Reply briefly, avoid inventing commitments, and keep tone factual.

MCP resources (7):
- keyid://identity/current: Current email, phone, and profile state.
- keyid://inbox/unread: Recent unread inbound messages.
- keyid://reputation/current: Current reputation score and factor breakdown.
- keyid://totp/services: Stored TOTP entries.
- keyid://registrations/recent: Recent service registrations.
- keyid://vault/keys: Stored secret keys without their values.
- keyid://registration-sessions/active: Recent signup sessions for the current identity, newest first.

Project access (required):
- POST /api/provision REQUIRES projectKey ("pk_..."). The open shared pool is closed: a request without a project key is refused with 403 "Project key required", and an invalid/revoked key also returns 403 (never falls back). Agents are provisioned onto domains AND phone numbers reserved for that project; the same project agent draws email domains (provision) and SMS numbers (requestPhone / SMS leases) from the reserved pool. SDKs: new KeyID({ projectKey }) / KeyID(project_key=...) or KEYID_PROJECT_KEY env var. Self-serve: pick a plan at https://keyid.ai/#pricing and the key is issued immediately with a warmed domain reserved to it. Invoices/POs/DPAs handled directly.

Key API endpoints:
- POST /api/provision
- POST /api/auth/challenge
- POST /api/auth/verify
- GET /api/identity
- POST /api/phone
- POST /api/registration-sessions
- GET /api/registration-sessions
- GET /api/registration-sessions/{id}/artifacts
- PUT /api/registration-sessions/{id}/browser-state
- POST /api/registration-sessions/{id}/complete
- POST /api/registration-sessions/{id}/block
- GET /api/inbox
- GET /api/threads
- POST /api/send
- GET /api/totp
- GET /api/reputation
- GET /api/metrics
- GET /api/version

MCP docs funnel:
- /mcp
- /mcp/signup
- /mcp/claude
- /mcp/cursor
- /mcp/verification
- /mcp/otp
- /lovable
- /replit

Examples:
- examples/mcp/claude-desktop-local.md
- examples/mcp/claude-code-local.md
- examples/mcp/cursor-local.md
- examples/mcp/claude-remote.md
- examples/mcp/cursor-remote.md
- examples/mcp/signup-session-workflow.md
- examples/mcp/verification-workflow.md
- examples/mcp/otp-and-totp-workflow.md
- examples/mcp/autonomous-signup-workflow.md
- examples/mcp/inbox-triage-workflow.md