# SeaTalk MCP Server

An MCP server that connects to the SeaTalk Open Platform API, giving you 8 tools:

| Tool | What it does |
|------|-------------|
| `send_direct_message` | Send a DM to a SeaTalk user via the bot |
| `send_group_message` | Send a message to a group chat |
| `list_groups` | List all groups the bot has joined |
| `get_group_info` | Get details about a specific group |
| `get_group_history` | Read recent messages in a group (up to 7 days) |
| `find_employee_by_email` | Look up employee codes by email |
| `get_message` | Retrieve a specific message by ID |
| `get_thread_messages` | Read messages in a thread |

---

## Prerequisites

1. **Node.js 18+** — Download from [nodejs.org](https://nodejs.org) (pick LTS)
2. **SeaTalk App credentials** — From [open.seatalk.io](https://open.seatalk.io):
   - Create an App/Bot
   - Copy your **App ID** and **App Secret**
   - Enable messaging and contacts capabilities

---

## Quick Start (Local)

```bash
# Install dependencies
npm install

# Build the TypeScript code
npm run build

# Set your credentials and run
SEATALK_APP_ID=your_id SEATALK_APP_SECRET=your_secret npm start
```

The server starts on `http://localhost:3000/sse`.

---

## Deploy to Railway (Recommended for Non-Devs)

1. Go to [railway.app](https://railway.app) and sign up (free tier available)
2. Click **"New Project"** → **"Deploy from GitHub repo"**
3. Connect your GitHub and upload this code (or use "Deploy from local")
4. Go to **Variables** tab and add:
   - `SEATALK_APP_ID` = your App ID
   - `SEATALK_APP_SECRET` = your App Secret
   - `PORT` = 3000
5. Railway will auto-detect the Dockerfile and deploy
6. Copy the public URL Railway gives you (e.g., `your-app.up.railway.app`)
7. Your MCP endpoint is: `https://your-app.up.railway.app/sse`

---

## Deploy to Render

1. Go to [render.com](https://render.com) and sign up
2. Click **"New"** → **"Web Service"**
3. Connect your repo or upload code
4. Set **Build Command**: `npm install && npm run build`
5. Set **Start Command**: `npm start`
6. Add Environment Variables:
   - `SEATALK_APP_ID` = your App ID
   - `SEATALK_APP_SECRET` = your App Secret
7. Deploy and copy the URL

---

## Connect to Migoo

Once deployed, add it as a custom MCP:
1. Use the URL: `https://YOUR-DEPLOYED-URL/sse`
2. That's it — the tools will appear automatically

---

## Project Structure

```
seatalk-mcp-server/
├── src/
│   └── index.ts      ← Main server code (all tools + API client)
├── package.json       ← Dependencies
├── tsconfig.json      ← TypeScript config
├── Dockerfile         ← For Docker-based deploys
├── Procfile           ← For Railway/Heroku
├── .env.example       ← Template for env vars
└── README.md          ← This file
```