# Swamix MCP Tools

> Common workflow tools (mail, LLM, video, web) exposed as one MCP server. Connect any MCP client to `https://mcp.swamix.com/mcp` (streamable HTTP, header `Authorization: Bearer <MCP_TOKEN>`). This file is the URL index — regenerate from live tool docstrings on every deploy.

## Connect

- Server URL: https://mcp.swamix.com/mcp (transport: streamable-http / MCP 2025-03-26)
- Auth: `Authorization: Bearer $MCP_TOKEN` 
- Human index (this file): https://mcp.swamix.com/llms.txt

## Tools

- **fetch_url**(url: string, max_chars: integer): Fetch a web page and return its readable text (HTML stripped).
- **get_mail**(folder: string, unread_only: boolean, limit: integer): Fetch the most recent emails from the configured IMAP account.
- **llm_call**(messages: array, model: string, temperature: number, max_tokens: integer): Make an LLM chat completion call (OpenAI-compatible: Mistral primary, Cerebras failover). Returns {text, usage}.
- **search_web**(query: string, limit: integer): Search the web via DuckDuckGo (no API key) and return top results.
- **send_email**(to: string, subject: string, body: string, cc: string): Send an email via the configured SMTP account.
- **split_video**(source: string, segment_minutes: integer): Split a video into equal-length segments with ffmpeg.
- **understand_audio**(audio: string, mime: string, instructions: string, schema: any): Understand audio with Gemini — transcription, speakers, music/sounds. Returns `result_url` (hosted JSON, evicted after 7 days) + `usage`; small results also inline under `result`.
- **understand_image**(image: string, mime: string, instructions: string, schema: any): Understand an image with Gemini vision — description, OCR, extraction. Returns `result_url` (hosted JSON, evicted after 7 days) + `usage`; small results also inline under `result` (schema-shaped dict, or freeform under result.text).
- **understand_video**(video: string, mime: string, instructions: string, schema: any): Understand a video with Gemini (native timestamps) — chronological analysis with [MM:SS] markers. Returns `result_url` (hosted JSON, evicted after 7 days) + `usage`; small results also inline under `result`.

## Notes

- All tools are synchronous and safe to call serially; `llm_call` accepts `messages` as a list of `{role, content}` and returns `{text, usage}`.
- AI tools (`llm_call`, `understand_*`) are rate-limited per caller per rolling 24h: `understand_image` 15/day, `understand_video` 5/day, `understand_audio` 10/day, `llm_call` 30/day. They require the server API key and a configured `GEMINI_API_KEY` (understand_*).
- `understand_*` accept https URL / data-URI / base64 media, auto-convert unsupported formats via ffmpeg, and return `result_url` — a hosted JSON link (`{result, usage}`) evicted after 7 days; small results are also inline under `result`.
- `split_video` writes segments to the server's /tmp/splits — copy them off with scp/rsync.
- Search source of truth: [github.com/nikhil-swamix/AGENTS-MCPS-TOOLS](https://github.com/nikhil-swamix/AGENTS-MCPS-TOOLS).