# mern_chat_app MCP server

Generated from [https://github.com/yogsgehlot/Mern-Chat-App](https://github.com/yogsgehlot/Mern-Chat-App) (commit `21caed2360bb39358ee031eb29e521a1a1ae1c90`).

## Setup

1. `pip install -e .` (or `pip install -r requirements.txt` if provided separately).
2. Copy `.env.example` to `.env` and fill in the values below, or have your
   deployment platform inject them as environment variables directly -
   nothing here contains real credentials.
3. Run: `python server.py`

## Required environment variables

| Variable | Secret? | Purpose |
|---|---|---|
| `MERN_CHAT_APP_BASE_URL` | no | Base URL of the running mern_chat_app API instance |


## Transport

Two transports, selected via `MCP_TRANSPORT`:

- `stdio` (default) - the standard subprocess transport most MCP hosts use.
- `streamable-http` - hosts this server over HTTP/HTTPS at `/mcp`, so it can
  run as a standalone network service. Configure with:
  - `HOST` (default `0.0.0.0`), `PORT` (default `8000`)
  - `MCP_TLS_CERTFILE` / `MCP_TLS_KEYFILE` - set both to serve HTTPS directly;
    otherwise plain HTTP is served (fine behind a TLS-terminating proxy/ingress).

  Example: `MCP_TRANSPORT=streamable-http PORT=8000 python server.py`

## Tools

- **register_user** - Register a new user account and receive a JWT token in the response.
- **login_user** - Authenticate a user with email and password and receive a JWT token in the response.
- **search_users** - Search or list all users except the authenticated user; requires JWT Bearer token from login or registration (user-login auth, not a static API key).
- **access_chat** - Create or fetch a one-to-one chat with another user; requires JWT Bearer token from login or registration.
- **fetch_chats** - Fetch all chats for the authenticated user sorted by most recently updated; requires JWT Bearer token from login or registration.
- **create_group_chat** - Create a new group chat; requires JWT Bearer token. The users field must be a JSON-stringified array of user ObjectId strings, not a native JSON array.
- **rename_group_chat** - Rename an existing group chat; requires JWT Bearer token from login or registration.
- **remove_from_group** - Remove a user from a group chat; requires JWT Bearer token from login or registration.
- **add_to_group** - Add a user to a group chat; requires JWT Bearer token from login or registration.
- **get_chat_messages** - Retrieve all messages for a chat; requires JWT Bearer token from login or registration.
- **send_message** - Send a new message in a chat and update the chat latestMessage; requires JWT Bearer token from login or registration.