# KeyID.ai

Registration infrastructure for AI agents.

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

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

Current package versions from /api/version:
- @keyid/sdk 0.2.9
- @keyid/agent-kit 0.2.10
- keyid 0.2.9

MCP tools (47):
- 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
- 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

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.

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