Skip to main content
Glama
achenglike

ThePornDB MCP Service

by achenglike
OverviewSchemaRelated ServersScoreDiscussions
Remote

ThePornDB MCP Service

An MCP (Model Context Protocol) service that exposes ThePornDB API functionality as tools to LLM applications like Claude Desktop, Claude Code, and other MCP-compatible clients.

Features

  • Search Content: Search for adult video scenes, movies, and JAV content with year filtering

  • Content Details: Retrieve complete metadata including performer information, images, and external references

  • Performer Lookup: Search for performers and get detailed profiles with bios and measurements

  • Secure Authentication: Token-based API authentication with startup validation

  • Automatic Retry: Built-in retry logic with exponential backoff for rate limit handling

Installation

From GitHub (Recommended)

Install the latest stable release:

pip install git+https://github.com/achenglike/theporndb-mcp.git@v1.0.0

Or using uv (10-100x faster):

uv tool install git+https://github.com/achenglike/theporndb-mcp.git@v1.0.0

From Source (Development)

# Clone the repository git clone https://github.com/achenglike/theporndb-mcp.git cd theporndb-mcp # Create virtual environment python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install dependencies pip install -e .

Configuration

The service accepts your ThePornDB API token via the --token command-line argument:

# Using your own token theporndb-mcp --token=your_api_token_here # Using default public token (no token provided) theporndb-mcp

Getting a Token

  1. Visit https://theporndb.net

  2. Create an account or log in

  3. Navigate to API settings

  4. Copy your API token

Command-Line Options

--token TOKEN ThePornDB API token (uses default public token if not provided) --log-level LEVEL Logging level: DEBUG, INFO, WARNING, ERROR (default: INFO) --transport TYPE MCP transport: stdio, streamable-http (default: stdio)

Running the Server

Development Mode (stdio transport)

For testing with MCP Inspector:

theporndb-mcp --token=your_token # With debug logging theporndb-mcp --token=your_token --log-level=DEBUG

Production Mode (HTTP transport)

theporndb-mcp --token=your_token --transport=streamable-http # Server will listen on http://localhost:8000/mcp

Testing with MCP Inspector

  1. Start the MCP server:

    theporndb-mcp --token=your_token

  2. Start MCP Inspector in another terminal:

    npx -y @modelcontextprotocol/inspector

  3. Connect Inspector to the server

Available Tools

Tool

Description

search_scenes

Search for adult video scenes by term and optional year

search_movies

Search for full-length movies by term and optional year

search_jav

Search for Japanese Adult Video content by term and optional year

get_content_details

Get complete details for a specific content item by ID

search_performers

Search for performers by name

get_performer_details

Get complete performer profile with bio and measurements

Example Usage

# Example: Search for scenes await mcp.call_tool("search_scenes", { "search_term": "brazzers vacation", "year": 2023 }) # Example: Get content details await mcp.call_tool("get_content_details", { "content_id": "abc123", "content_type": "scene" }) # Example: Search performers await mcp.call_tool("search_performers", { "name": "Angela White" })

Development

Running Tests

# Install dev dependencies pip install -e ".[dev]" # Run tests pytest # Run with coverage pytest --cov=src --cov-report=html

License

MIT License - see LICENSE file for details

Support

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/achenglike/theporndb-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server