# Tiktok Mcp

> A Model Context Protocol service for TikTok video discovery and metadata extraction.

- **Type:** MCP server
- **Install:** `agentstack add mcp-yap-audio-tiktok-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [yap-audio](https://agentstack.voostack.com/s/yap-audio)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [yap-audio](https://github.com/yap-audio)
- **Source:** https://github.com/yap-audio/tiktok-mcp
- **Website:** https://www.vibeout.sh

## Install

```sh
agentstack add mcp-yap-audio-tiktok-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# TikTok MCP Service

A Model Context Protocol service for TikTok video discovery and metadata extraction. This service provides a robust interface for searching TikTok videos by hashtags and retrieving trending content, with built-in anti-detection measures and error handling.

## Features

- Search videos by hashtags
- Configurable video count per search (default: 30)
- Anti-bot detection measures
- Proxy support
- Automatic API session management
- Rate limiting and error handling
- Health status monitoring

## Configuration

The service uses environment variables for configuration. Create a `.env` file with:

```env
ms_token=your_tiktok_ms_token  # Optional but recommended to avoid bot detection
TIKTOK_PROXY=your_proxy_url    # Optional proxy configuration
```

## Installation and Setup

```bash
# Install dependencies
poetry install

# Install browser automation dependencies
poetry run python -m playwright install

# Start the service
poetry run python -m tiktok_mcp_service.main
```

## Claude Desktop Integration

Once your service is running, you can integrate it with Claude Desktop. Since we're using Poetry for dependency management, make sure to run the MCP CLI commands through Poetry:

```bash
# Navigate to the project directory
cd /path/to/tiktok-mcp-service

# Install the service in Claude Desktop with Poetry in editable mode
poetry run mcp install tiktok_mcp_service/main.py --with-editable . -f .env

# Optional: Install with a custom name
poetry run mcp install tiktok_mcp_service/main.py --name "TikTok Video Search" --with-editable . -f .env
```

After installation, the service will be available in Claude Desktop and will run using Poetry for proper dependency management.

## API Endpoints

### Health Check
- `GET /health` - Check service health and API initialization status
  ```json
  {
    "status": "running",
    "api_initialized": true,
    "service": {
      "name": "TikTok MCP Service",
      "version": "0.1.0",
      "description": "A Model Context Protocol service for searching TikTok videos"
    }
  }
  ```

### Search Videos
- `POST /search` - Search for videos with hashtags
  ```json
  {
    "search_terms": ["python", "coding"],
    "count": 30  // Optional, defaults to 30
  }
  ```
  Response includes video URLs, descriptions, and engagement statistics (views, likes, shares, comments).

### Resource Management
- `POST /cleanup` - Clean up resources and API sessions

## Error Handling

The service includes comprehensive error handling for:
- API initialization failures
- Bot detection issues
- Network errors
- Rate limiting
- Invalid search terms

## Development

Built with:
- TikTokApi
- FastMCP
- Poetry for dependency management
- Playwright for browser automation

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [yap-audio](https://github.com/yap-audio)
- **Source:** [yap-audio/tiktok-mcp](https://github.com/yap-audio/tiktok-mcp)
- **License:** MIT
- **Homepage:** https://www.vibeout.sh

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-yap-audio-tiktok-mcp
- Seller: https://agentstack.voostack.com/s/yap-audio
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.