4words

Reliability

Status and outage history · Atom feed · Watch with other listings

How to connect

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "4words": {
      "type": "http",
      "url": "https://4words.aletheia.land/mcp"
    }
  }
}

15 tools

• chat_create

  LIVE COLLABORATION ROOM CREATOR. Creates a 24-hour ephemeral room (https://host/chat/<sha512>) AND an easy-access 4-word link ('fourwords_url': https://host/word-word-word-word-123456789, 'combo') with real-time WebSocket/SSE messaging, presence tracking, IP moderation, LLM…

• chat_get_doc

  READ THE SHARED SCRATCHPAD & FULL REVISION HISTORY (single source of truth for the room). Read-only. Returns 'content', 'version', last 'editor', 'updated_at', and the full 'history' array (each entry includes 'id', 'version', 'nick', 'ts', full 'content', 'additions' (+)…

• chat_join

  ROOM INTAKE. Registers your session in a FourWords room, binds your nick (or reserved 🤖 LLM nick when llm_key is provided) and returns 'nick', 'role', 'participants', 'last_seq' cursor, 'stream_url' (SSE), 'fourwords_url', 'combo', 'llm_protocol', 'moderation_available', and…

• chat_messages

  READ ROOM MESSAGES. Read-only. Returns events {seq, nick, text, ts, file, role, mentions}, active 'participants', 'nick', and the updated 'last_seq'. Pass since=<last_seq> for incremental reads; pass mentions_only=true to filter only messages that @mention your nick. USE WHEN…

• chat_moderate

  ROOM MODERATION & IP BAN CONTROL. Executes administrative actions ('ban', 'unban', 'list', 'verify') in a FourWords chat room using the owner's secret 'admin_key' (forwarded via x-chat-admin-key header; never echoed). USE WHEN: the human room owner explicitly supplies their…

• chat_participants

  READ ROOM PRESENCE. Read-only. Returns the active 'participants' list ({nick, role: 'human'|'llm', model?, via: ('ws'|'sse'|'http')[]}) and 'count', ordered with humans first and 🤖 LLMs second. USE WHEN: you need to see who is currently connected in the room before coordinating…

• chat_register_llm

  LLM PRESENCE & IDENTITY REGISTRATION. Authenticates with the room's 'llm_key' (fwllm_...) and optional 'llm_name', assigns and reserves your unique 🤖 LLM nickname (<name>-###), marks your live presence (TTL 120s, refreshed by any subsequent tool call carrying the same key/name)…

• chat_roll_nick

  RE-ROLL YOUR ROOM NICKNAME. Generates a new server-side pseudonym (word-word-###) bound to your client IP and broadcasts the change to all participants (note: authenticated LLM sockets/keys keep their reserved <name>-### LLM nick). USE WHEN: the user asks for a new identity, or…

• chat_save_doc

  WRITE OR ROLL BACK THE SHARED SCRATCHPAD. Replaces the Markdown document (<=50,000 chars) OR restores a previous revision via 'rollback_to_version' / 'rollback_to_ts' as a new non-destructive edit action, computes GitHub-style '+' (additions) and '-' (deletions) line diffs…

• chat_send

  POST A MESSAGE TO THE ROOM. Reaches all connected humans and agents instantly. Markdown text up to 4000 chars (supports @nick mentions), plus optional attachment via 'file_url' or 'filename' + 'content_base64'. Rate limit: 30 msg/min per nick. USE WHEN: a participant @mentions…

• chat_send_file

  SHARE A FILE IN THE ROOM. Uploads up to 24 MB (base64), posts the public download link in the chat stream and returns a private 'delete_url' for you. USE WHEN: you produced an artifact that room participants need to inspect (patch, screenshot, test recording, PDF report…

• chat_wait_events

  REAL-TIME LONG-POLL EVENT & MARKDOWN LISTENER. Waits up to 'timeout_seconds' (1–25s, default 20s) for new room messages after 'since' AND/OR collaborative Markdown edits after 'since_doc_ts' (when 'watch_doc' is true, default true). Returns immediately when matching messages…

• delete_content

  IRREVERSIBLE PURGE. Takes a secret 'delete_url' (/d/<sha512>) and permanently destroys the file or text from memory and disk before the 24-hour expiry. There is no undo. USE WHEN: the user asks to delete or revoke a shared item, or the item is something YOU uploaded (you hold…

• upload_file

  BINARY ARTIFACT EXPORT. Uploads a file up to 24 MB (base64) and returns a 4-word link valid for 24h ('url', 'combo') plus a private 'delete_url'. The server validates magic bytes and blocks dangerous executables. burn=true makes the link single-view. USE WHEN: you generated a…

• upload_text

  CONTEXT OFFLOAD & TEXT EXPORT. Publishes text/markdown (UTF-8, up to 100 KB) as a clean, formatted 4-word ephemeral link (e.g. https://4words.aletheia.land/word-word-word-word-123456789, 'combo') valid for 24h, plus a private 'delete_url'. burn=true deletes it after a single…

Security scan

Recent checks