Skip to main content
Glama
Talhelf
by Talhelf

Pornhub MCP Server

An MCP (Model Context Protocol) server that provides real-time and historical statistics about the adult entertainment industry using Google Trends API only.

Features

This MCP server provides 100% API-based tools (no cached data):

  1. search_trends - Analyze any keywords with full statistics

    • Interest over time with trends

    • Regional breakdown

    • Related & rising queries

  2. compare_performers - Compare search interest between performers

    • Side-by-side comparison

    • Growth trends

    • Regional popularity

  3. compare_platforms - Compare platform popularity

    • Pornhub vs OnlyFans vs xVideos, etc.

    • Market share trends

    • Regional preferences

  4. analyze_category_trends - Analyze content category trends

    • MILF, Teen, Amateur, Hentai, etc.

    • Trend direction (growing/declining)

    • Regional variations

  5. historical_analysis - Multi-year analysis (2004+)

    • Long-term trends

    • Peak periods

    • Growth patterns

  6. trending_searches - Find related & rising searches

    • What else people search for

    • Breakout terms

    • Related performers/categories

Related MCP server: wikipedia-trends-mcp

Data Source

100% Real-time API - No Cached Data

  • Coverage: 2004 to present

  • Geographic: Worldwide + country-specific + US state-level

  • Data Points: Search interest (0-100 scale), regional breakdown, related queries, trending terms

  • Rate Limiting: Built-in delays to respect API limits

  • Caching: 1-hour cache to avoid redundant API calls

  • Free: No API key required

What You Can Query

  • Any performer name (from 2004+)

  • Any platform (pornhub, onlyfans, xvideos, etc.)

  • Any category (milf, teen, amateur, hentai, etc.)

  • Any search term

  • Compare up to 5 terms at once

  • Custom date ranges

  • Regional analysis (US states, countries, worldwide)

Installation

Prerequisites

  • Python 3.10 or higher

  • uv package manager (recommended) or pip

Setup

  1. Install uv (if not already installed):

curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Create virtual environment and install dependencies:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

Running the Server

Standalone Testing

Run the server directly:

uv run server.py

Configure with Claude Desktop

  1. Edit your Claude Desktop config file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add the server configuration (choose one method):

Method A: Using the virtual environment directly (Recommended)

{
  "mcpServers": {
    "pornhub-mcp": {
      "command": "/Users/talhelfgott/Desktop/api/.venv/bin/python",
      "args": [
        "/Users/talhelfgott/Desktop/api/server.py"
      ]
    }
  }
}

Method B: Using uv (if you prefer)

{
  "mcpServers": {
    "pornhub-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/talhelfgott/Desktop/api",
        "--no-project",
        "python",
        "server.py"
      ]
    }
  }
}
  1. Restart Claude Desktop

Example Queries

Once connected to Claude Desktop, you can ask:

šŸ” Performer Analysis

  • "Compare search trends for Lana Rhoades vs Riley Reid from 2020-2024"

  • "Show me Google Trends for Abella Danger over the past 5 years"

  • "Which performer has more search interest: [name A] or [name B]?"

  • "Analyze historical trends for [any performer] from 2020 to 2024"

  • "What states search for [performer name] the most?"

šŸ“Š Platform Comparison

  • "Compare Pornhub vs OnlyFans vs xVideos search trends"

  • "Is OnlyFans growing or declining in popularity?"

  • "Show me the trend for Pornhub over the past 5 years"

  • "Which platform is most popular in California?"

  • "Compare milf vs teen vs amateur category searches"

  • "Is hentai search interest growing or declining?"

  • "Show me trends for ethical porn searches"

  • "What are the trending adult categories right now?"

šŸŒŽ Regional Analysis

  • "Which US states have the highest search interest for OnlyFans?"

  • "Show me UK vs US search interest for [any term]"

  • "What are people searching for related to Pornhub?"

šŸ“… Historical Queries

  • "Show me 2020-2024 trends for [any performer]"

  • "Compare 2020 vs 2024 for [platform or category]"

  • "What was the peak year for [any search term]?"

  • "Analyze the past 5 years of [anything]"

Project Structure

api/
ā”œā”€ā”€ server.py           # Main MCP server implementation
ā”œā”€ā”€ pyproject.toml      # Project dependencies
└── README.md          # This file

Data Updates

The current implementation uses cached/sample data. To add real-time data:

  1. AdultDataLink API: Sign up at https://adultdatalink.com/ and add API integration

  2. Web Scraping: Implement scrapers for public statistics sites

  3. Platform APIs: Integrate official APIs where available

Privacy & Ethics

This server is designed for:

  • Market research and analysis

  • Industry statistics and trends

  • Educational purposes

All data is aggregated statistics from public sources. No personal data or explicit content is accessed or stored.

License

MIT License - See LICENSE file for details

Contributing

Contributions welcome! Please ensure:

  • Data sources are legitimate and ethical

  • No explicit content or personal data

  • Focus on industry statistics and analytics

Available Tools

6 tools
compare_performersB
Compare Google search trends between different performers.

Args:
    performer_names: List of performer names to compare (max 5)
                    Example: ["Lana Rhoades", "Riley Reid", "Abella Danger"]
    timeframe: Time period (default: past 12 months)
               Use 'today 5-y' for 5 year comparison
               Use '2020-01-01 2024-12-31' for custom range
    region: Region code (default: US)

Returns:
    Comparative analysis showing which performer has higher search interest.
ParametersJSON Schema
NameRequiredDescriptionDefault
performer_namesYes
timeframeNotoday 12-m
regionNoUS

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions the tool returns a 'comparative analysis showing which performer has higher search interest,' which gives some output context. However, it lacks details on rate limits, authentication needs, data freshness, or error handling. For a tool with zero annotation coverage, this leaves significant behavioral gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is efficiently structured with clear sections: purpose statement, parameter explanations with examples, and return value description. Every sentence adds value without redundancy. It's appropriately sized and front-loaded with the core functionality.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's moderate complexity (3 parameters, no annotations, but with an output schema), the description is reasonably complete. It covers parameter semantics thoroughly, states the purpose clearly, and mentions the return value. The output schema likely details the 'comparative analysis,' so the description doesn't need to explain return values further. Minor gaps include lack of behavioral context and usage guidelines.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds substantial meaning beyond the input schema, which has 0% description coverage. It explains each parameter: 'performer_names' as a list with a max of 5 and an example, 'timeframe' with default and format examples, and 'region' with default. This compensates well for the schema's lack of descriptions, though it doesn't cover all possible edge cases.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Compare Google search trends between different performers.' This specifies the verb ('compare'), resource ('Google search trends'), and target ('performers'). It distinguishes from siblings like 'analyze_category_trends' or 'compare_platforms' by focusing specifically on performers, though it doesn't explicitly contrast with them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. While it implicitly suggests use for comparing performer search trends, it doesn't mention when to choose this over siblings like 'search_trends' or 'historical_analysis', nor does it specify prerequisites or exclusions. Usage context is implied but not explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

compare_platformsB
Compare Google search trends between different adult platforms.

Args:
    platform_names: List of platform names (max 5)
                   Example: ["pornhub", "onlyfans", "xvideos"]
    timeframe: Time period (default: past 12 months)
    region: Region code (default: US)

Returns:
    Comparative analysis showing platform popularity trends.
ParametersJSON Schema
NameRequiredDescriptionDefault
platform_namesYes
timeframeNotoday 12-m
regionNoUS

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions the tool 'compares' trends and returns a 'comparative analysis,' but doesn't disclose critical traits such as data source limitations, rate limits, authentication needs, or whether it's a read-only operation. For a tool with no annotations, this leaves significant gaps in understanding its behavior and constraints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded, starting with the core purpose followed by parameter details and return information. Each sentence adds value without redundancy. However, the parameter explanations could be slightly more concise, and the structure includes a separate 'Args' and 'Returns' section, which is clear but not maximally efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (3 parameters, no annotations, but has an output schema), the description is moderately complete. It covers the purpose and parameters well, and the output schema handles return values, so the description doesn't need to explain those. However, it lacks behavioral context and usage guidelines, making it incomplete for optimal agent understanding without additional structured data.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds meaningful semantics beyond the input schema, which has 0% description coverage. It explains each parameter: 'platform_names' as a list of names with a max of 5 and an example, 'timeframe' as a time period with a default, and 'region' as a region code with a default. This compensates well for the low schema coverage, though it doesn't detail format specifics like valid region codes or timeframe syntax.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Compare Google search trends between different adult platforms.' It specifies the verb ('compare'), resource ('Google search trends'), and domain ('adult platforms'). However, it doesn't explicitly differentiate from sibling tools like 'analyze_category_trends' or 'compare_performers,' which might also involve comparisons in similar domains.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like 'compare_performers' or 'search_trends,' nor does it specify scenarios where this tool is preferred or excluded. Usage is implied by the purpose but lacks explicit context or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

historical_analysisB
Analyze historical trends for a keyword across multiple years.

Args:
    keyword: Single keyword to analyze (performer, platform, or category)
            Example: "Lana Rhoades", "onlyfans", "milf"
    start_year: Starting year (2004 or later)
    end_year: Ending year (default: 2024)
    region: Region code (default: US)

Returns:
    Multi-year trend analysis showing growth, peaks, and patterns.
ParametersJSON Schema
NameRequiredDescriptionDefault
keywordYes
start_yearNo
end_yearNo
regionNoUS

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions the tool returns 'Multi-year trend analysis showing growth, peaks, and patterns,' which gives some output context, but it lacks critical details: it doesn't specify data sources, rate limits, authentication needs, error conditions, or whether it's a read-only operation. For a tool with no annotations, this leaves significant gaps in understanding its behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured and appropriately sized. It front-loads the purpose in the first sentence, then lists parameters and returns in clear sections. Every sentence adds value, with no redundant or vague phrasing. Minor improvements could include briefer examples or combining some details, but overall it's efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's moderate complexity (4 parameters, no annotations, but has an output schema), the description is partially complete. It covers the purpose and parameters well, and the output schema likely handles return values, reducing the need for detailed output explanation. However, it lacks behavioral context (e.g., data sources, limitations) and usage guidelines, making it adequate but with clear gaps for an agent to operate effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It adds meaningful semantics beyond the schema: it explains that 'keyword' can be a performer, platform, or category with examples ('Lana Rhoades', 'onlyfans', 'milf'), specifies constraints for 'start_year' ('2004 or later'), and clarifies defaults for 'end_year' and 'region'. This effectively documents all parameters, though it could provide more detail on format (e.g., region code standards).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Analyze historical trends for a keyword across multiple years.' It specifies the verb ('analyze'), resource ('historical trends'), and scope ('keyword across multiple years'), making it easy to understand what the tool does. However, it doesn't explicitly differentiate this from sibling tools like 'analyze_category_trends' or 'compare_performers', which likely have overlapping functionality.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like 'analyze_category_trends' or 'compare_performers', nor does it specify prerequisites, exclusions, or typical use cases. The agent must infer usage from the purpose alone, which is insufficient for optimal tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 6 tool updatesv2.0.0
    • First observedanalyze_category_trends
    • First observedcompare_performers
    • First observedcompare_platforms
    • First observedhistorical_analysis
    • First observedsearch_trends
    • First observedtrending_searches

TDQS

A3.5/5.0
Disambiguation4/5

Most tools have distinct purposes focused on different types of trend analysis (categories, performers, platforms, historical, general search, and related searches). However, there is some overlap between 'search_trends' and the more specific comparison tools, as 'search_trends' can analyze similar keywords but with a broader scope, which could cause mild confusion.

Naming Consistency5/5

All tool names follow a consistent snake_case pattern with clear verb_noun structures (e.g., analyze_category_trends, compare_performers, historical_analysis). The naming is predictable and readable throughout the set, enhancing usability.

Tool Count5/5

With 6 tools, the server is well-scoped for analyzing adult content trends via Google Trends. Each tool serves a specific analytical function, and the count is neither too sparse nor bloated, fitting the domain effectively.

Completeness4/5

The tool set covers key aspects of trend analysis for adult content, including comparisons, historical data, and related searches. A minor gap is the lack of tools for real-time or predictive analytics, but the existing tools allow agents to handle most common analytical workflows in this domain.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Real-time trend data from Google Trends (Search, Images, News, Shopping), YouTube, TikTok, Reddit, Amazon, Wikipedia, npm, Steam, Spotify, X (Twitter), App Store, Google Play, web traffic, and news sentiment via one MCP connection. Works with Claude, Cursor, VS Code, Windsurf, ChatGPT, and any MCP-compatible AI.
    28
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides Wikipedia page view trend data including spike detection, historical traffic, and cross-platform comparison, enabling AI to access a leading indicator of public curiosity.
    MIT
  • A
    license
    Not graded
    quality
    F
    maintenance
    Provides AI agents with real-time social trends, cross-platform sentiment, viral content velocity, and brand mentions from Reddit, Hacker News, and Google Trends.
    MIT

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/Talhelf/ph-mcp'

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