io.github.smeet666/mcp-stashbox MCP Server

Name: io.github.smeet666/mcp-stashbox MCP Server
Author: io.github.smeet666

io.github.smeet666/mcp-stashbox

Repository Registry

What is the io.github.smeet666/mcp-stashbox MCP server?

Search scenes, performers, studios and tags across the public stash-box catalogues.

How to install io.github.smeet666/mcp-stashbox

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

STASHBOX_STASHDB_KEY
API key for StashDB. A catalogue with no key is named as absent from every answer.
STASHBOX_TPDB_KEY
API key for ThePornDB. A catalogue with no key is named as absent from every answer.
STASHBOX_FANSDB_KEY
API key for FansDB. A catalogue with no key is named as absent from every answer.
STASHBOX_PMV_KEY
API key for PMV Stash. A catalogue with no key is named as absent from every answer.
STASHBOX_JAVSTASH_KEY
API key for JAVStash. A catalogue with no key is named as absent from every answer.
SB_USER_AGENT
Identify your own client. This project's identifier and a contact address stay appended, so a catalogue can always reach a human.
SB_MIN_INTERVAL_MS
Minimum milliseconds between requests to one catalogue. Default and floor 1000, ceiling 60000. The floor cannot be lowered.
SB_TIMEOUT_MS
Deadline for one request, in milliseconds. Default 20000.
SB_MAX_RETRIES
Retries on a busy catalogue. Default 3.
SB_CACHE_TTL_MS
In-memory cache lifetime, in milliseconds. Default 300000. Set 0 to turn it off.
SB_CACHE_MAX_ENTRIES
In-memory cache size, in entries. Default 500.
SB_LOG_LEVEL
error, info or debug. Default error. Logs go to stderr.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-stashbox": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-stashbox"
      ],
      "env": {
        "STASHBOX_STASHDB_KEY": "<YOUR_STASHBOX_STASHDB_KEY>",
        "STASHBOX_TPDB_KEY": "<YOUR_STASHBOX_TPDB_KEY>",
        "STASHBOX_FANSDB_KEY": "<YOUR_STASHBOX_FANSDB_KEY>",
        "STASHBOX_PMV_KEY": "<YOUR_STASHBOX_PMV_KEY>",
        "STASHBOX_JAVSTASH_KEY": "<YOUR_STASHBOX_JAVSTASH_KEY>",
        "SB_USER_AGENT": "<YOUR_SB_USER_AGENT>",
        "SB_MIN_INTERVAL_MS": "<YOUR_SB_MIN_INTERVAL_MS>",
        "SB_TIMEOUT_MS": "<YOUR_SB_TIMEOUT_MS>",
        "SB_MAX_RETRIES": "<YOUR_SB_MAX_RETRIES>",
        "SB_CACHE_TTL_MS": "<YOUR_SB_CACHE_TTL_MS>",
        "SB_CACHE_MAX_ENTRIES": "<YOUR_SB_CACHE_MAX_ENTRIES>",
        "SB_LOG_LEVEL": "<YOUR_SB_LOG_LEVEL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-stashbox": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-stashbox"
      ],
      "env": {
        "STASHBOX_STASHDB_KEY": "<YOUR_STASHBOX_STASHDB_KEY>",
        "STASHBOX_TPDB_KEY": "<YOUR_STASHBOX_TPDB_KEY>",
        "STASHBOX_FANSDB_KEY": "<YOUR_STASHBOX_FANSDB_KEY>",
        "STASHBOX_PMV_KEY": "<YOUR_STASHBOX_PMV_KEY>",
        "STASHBOX_JAVSTASH_KEY": "<YOUR_STASHBOX_JAVSTASH_KEY>",
        "SB_USER_AGENT": "<YOUR_SB_USER_AGENT>",
        "SB_MIN_INTERVAL_MS": "<YOUR_SB_MIN_INTERVAL_MS>",
        "SB_TIMEOUT_MS": "<YOUR_SB_TIMEOUT_MS>",
        "SB_MAX_RETRIES": "<YOUR_SB_MAX_RETRIES>",
        "SB_CACHE_TTL_MS": "<YOUR_SB_CACHE_TTL_MS>",
        "SB_CACHE_MAX_ENTRIES": "<YOUR_SB_CACHE_MAX_ENTRIES>",
        "SB_LOG_LEVEL": "<YOUR_SB_LOG_LEVEL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-stashbox": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-stashbox"
      ],
      "env": {
        "STASHBOX_STASHDB_KEY": "<YOUR_STASHBOX_STASHDB_KEY>",
        "STASHBOX_TPDB_KEY": "<YOUR_STASHBOX_TPDB_KEY>",
        "STASHBOX_FANSDB_KEY": "<YOUR_STASHBOX_FANSDB_KEY>",
        "STASHBOX_PMV_KEY": "<YOUR_STASHBOX_PMV_KEY>",
        "STASHBOX_JAVSTASH_KEY": "<YOUR_STASHBOX_JAVSTASH_KEY>",
        "SB_USER_AGENT": "<YOUR_SB_USER_AGENT>",
        "SB_MIN_INTERVAL_MS": "<YOUR_SB_MIN_INTERVAL_MS>",
        "SB_TIMEOUT_MS": "<YOUR_SB_TIMEOUT_MS>",
        "SB_MAX_RETRIES": "<YOUR_SB_MAX_RETRIES>",
        "SB_CACHE_TTL_MS": "<YOUR_SB_CACHE_TTL_MS>",
        "SB_CACHE_MAX_ENTRIES": "<YOUR_SB_CACHE_MAX_ENTRIES>",
        "SB_LOG_LEVEL": "<YOUR_SB_LOG_LEVEL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-stashbox": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-stashbox"
      ],
      "env": {
        "STASHBOX_STASHDB_KEY": "<YOUR_STASHBOX_STASHDB_KEY>",
        "STASHBOX_TPDB_KEY": "<YOUR_STASHBOX_TPDB_KEY>",
        "STASHBOX_FANSDB_KEY": "<YOUR_STASHBOX_FANSDB_KEY>",
        "STASHBOX_PMV_KEY": "<YOUR_STASHBOX_PMV_KEY>",
        "STASHBOX_JAVSTASH_KEY": "<YOUR_STASHBOX_JAVSTASH_KEY>",
        "SB_USER_AGENT": "<YOUR_SB_USER_AGENT>",
        "SB_MIN_INTERVAL_MS": "<YOUR_SB_MIN_INTERVAL_MS>",
        "SB_TIMEOUT_MS": "<YOUR_SB_TIMEOUT_MS>",
        "SB_MAX_RETRIES": "<YOUR_SB_MAX_RETRIES>",
        "SB_CACHE_TTL_MS": "<YOUR_SB_CACHE_TTL_MS>",
        "SB_CACHE_MAX_ENTRIES": "<YOUR_SB_CACHE_MAX_ENTRIES>",
        "SB_LOG_LEVEL": "<YOUR_SB_LOG_LEVEL>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-stashbox --env STASHBOX_STASHDB_KEY=<YOUR_STASHBOX_STASHDB_KEY> --env STASHBOX_TPDB_KEY=<YOUR_STASHBOX_TPDB_KEY> --env STASHBOX_FANSDB_KEY=<YOUR_STASHBOX_FANSDB_KEY> --env STASHBOX_PMV_KEY=<YOUR_STASHBOX_PMV_KEY> --env STASHBOX_JAVSTASH_KEY=<YOUR_STASHBOX_JAVSTASH_KEY> --env SB_USER_AGENT=<YOUR_SB_USER_AGENT> --env SB_MIN_INTERVAL_MS=<YOUR_SB_MIN_INTERVAL_MS> --env SB_TIMEOUT_MS=<YOUR_SB_TIMEOUT_MS> --env SB_MAX_RETRIES=<YOUR_SB_MAX_RETRIES> --env SB_CACHE_TTL_MS=<YOUR_SB_CACHE_TTL_MS> --env SB_CACHE_MAX_ENTRIES=<YOUR_SB_CACHE_MAX_ENTRIES> --env SB_LOG_LEVEL=<YOUR_SB_LOG_LEVEL> -- npx -y mcp-stashbox