# Algrow MCP Server

> Connect Algrow's YouTube intelligence to Claude via MCP.

## Tools

### Search
- search_shorts_channels: Find competitors and similar Shorts channels with AI search, filters, and growth metrics
- search_longform_channels: Find competitors and similar Longform channels with monetization status and duration filters
- search_viral_videos: Find viral videos or similar videos by video_url or text query across Shorts and Longform with view and upload filters
- search_by_thumbnail: Find thumbnails by visual similarity or niche/topic — for competitive research, thumbnail analysis, or finding thumbnail styles
- search_terminated_channels: Search terminated/deleted YouTube channels with metadata and growth metrics at time of termination
- search_terminated_by_thumbnail: Search terminated/deleted channel videos by visual thumbnail similarity — same as search_by_thumbnail but searches the terminated archive

### Workspace
- list_folders: List the user's saved folders with channel counts
- create_folder: Create a new folder for organizing saved channels
- rename_folder: Rename an existing folder
- delete_folder: Delete a folder and unsave every channel in it (destructive — confirms first)
- get_folder: Get all channels in a folder with live 24h growth metrics
- save_channels: Save one or more channels to a folder by channel ID
- unsave_channel: Remove a channel from the user's saved set
- move_channel: Move a saved channel from one folder to another

### Alerts
- list_alerts: List all the user's active alerts (paused and unpaused)
- create_alert: Create a growth alert on a channel, folder, or saved search — fires once a night when threshold is crossed
- pause_alert: Pause an alert without deleting it
- unpause_alert: Resume a previously paused alert
- delete_alert: Permanently delete an alert and its history
- get_triggered_alerts: Get the user's alert inbox — returns alerts that fired since last check

### Resolvers
- resolve_handle: Resolve a YouTube @handle to a stable channel ID (for use with save_channels)
- resolve_url: Resolve a YouTube channel or video URL to a stable channel ID (for use with save_channels)

### Generation
- list_voices: Browse ElevenLabs and Stealth TTS voices
- generate_tts: Generate text-to-speech audio with hosted URL output
- get_tts_job_status: Check TTS generation job status
- list_tts_jobs: List recent TTS jobs
- clone_voice: Clone a voice from an audio sample using the Stealth voice engine
- delete_voice: Delete a cloned Stealth voice
- generate_image: Generate AI images from text prompts with optional reference images
- generate_video: Generate AI videos from text prompts (Sora, Kling, Veo, Grok)
- remove_captions: Remove captions and watermarks from a video
- remove_sora_watermark: Remove the Sora watermark from a video

### Utility
- scrape_youtube: Scrape video data, transcripts, and comments from any YouTube channel or video
- read_transcript: Fetch full transcript text for a YouTube video using the transcript_url from scrape_youtube results
- health_check: Check API health and view current job counts

## Setup

```bash
claude mcp add algrow --transport http https://mcp.algrow.online/mcp --header "Authorization: Bearer your-api-key-here"
```

Or add to `.mcp.json`:
```json
{
  "mcpServers": {
    "algrow": {
      "type": "http",
      "url": "https://mcp.algrow.online/mcp",
      "headers": { "Authorization": "Bearer your-api-key-here" }
    }
  }
}
```

## Docs

- Full docs: https://algrow.online/mcp/docs
- Full docs for LLMs: https://algrow.online/mcp/llms-full.txt
- REST API docs: https://algrow.online/api/docs