# SayItVid MCP Server

[![SayItVid](https://img.shields.io/badge/Pronunciation-SayItVid-red)](https://sayitvid.com)
[![Model Context Protocol](https://img.shields.io/badge/MCP-Enabled-blue)](https://modelcontextprotocol.io)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

> Official Model Context Protocol (MCP) Server for [SayItVid](https://sayitvid.com) — Learn how English is really spoken.
> Search over 450,000 authentic video clips for exact spoken timestamps, IPA phonetics, syllable divisions, and natural language context.

---

## Features

- **Search Real Spoken Videos ()**: Retrieve millisecond-timestamped video segments from authentic conversations, lectures, and interviews. Filter by American (), British (), or Australian () accents.
- **Deep Phonetics & Dictionary ()**: Access International Phonetic Alphabet (IPA) transcriptions, syllable breakdowns, stressed syllable markers, heteronym pronunciation rules (e.g.  vs ), and pronunciation FAQs.
- **A-Z Directory Browsing ()**: Structured exploration of the English dictionary by letter or prefix.
- **Curated Practice Playlists ()**: Study targeted collections for IELTS vocabulary, tricky heteronyms, silent letters, and medical terminology.

---

## Quick Setup

### 1. Cursor IDE (Native Remote SSE)
Add to your Cursor MCP settings ():
- **Name**: 
- **Type**: 
- **URL**: 

### 2. Claude Desktop
Add to your Claude Desktop configuration file:
```json
{
  "mcpServers": {
    "sayitvid": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://sayitvid.com/api/mcp"]
    }
  }
}
```

### 3. Antigravity / Opencode
Add to `opencode.json`:
```json
{
  "mcp": {
    "sayitvid": {
      "type": "remote",
      "url": "https://sayitvid.com/api/mcp"
    }
  }
}
```

### 4. Direct JSON-RPC / HTTP
```bash
curl -X POST https://sayitvid.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_pronunciation",
      "arguments": {
        "query": "ephemeral",
        "accent": "uk"
      }
    }
  }'
```

---

## Available MCP Tools

| Tool | Description |
| :--- | :--- |
| `search_pronunciation` | Search video transcripts for timestamped clips, subtitles, and channel context. |
| `get_word_details` | Retrieve IPA phonetic transcription, syllables, stress index, and heteronym rules. |
| `browse_vocabulary` | Browse dictionary words by letter (A-Z) or prefix. |
| `get_public_playlists` | Retrieve curated study playlists (IELTS, heteronyms, silent letters). |

---

## Links & Attribution

- **Website**: [https://sayitvid.com](https://sayitvid.com)
- **Interactive Web Search**: [https://sayitvid.com/search](https://sayitvid.com)
- **API Documentation**: [https://sayitvid.com/api-docs](https://sayitvid.com/api-docs)
- **MCP Guide**: [https://sayitvid.com/mcp](https://sayitvid.com/mcp)
- **AI Agent Index**: [https://sayitvid.com/llms.txt](https://sayitvid.com/llms.txt)

---

## License

MIT License. See [LICENSE](LICENSE) for details.