mcp stashbox for Gemini CLI

io.github.smeet666/mcp-stashbox

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

client:Gemini CLI transport:stdio runtime:npm

Install mcp stashbox in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

STASHBOX_STASHDB_KEY

STASHBOX_TPDB_KEY

STASHBOX_FANSDB_KEY

STASHBOX_PMV_KEY

STASHBOX_JAVSTASH_KEY

SB_USER_AGENT

SB_MIN_INTERVAL_MS

SB_TIMEOUT_MS

SB_MAX_RETRIES

SB_CACHE_TTL_MS

SB_CACHE_MAX_ENTRIES

SB_LOG_LEVEL

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "mcp-stashbox": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-stashbox"
      ],
      "env": {
        "STASHBOX_STASHDB_KEY": "<STASHBOX_STASHDB_KEY>",
        "STASHBOX_TPDB_KEY": "<STASHBOX_TPDB_KEY>",
        "STASHBOX_FANSDB_KEY": "<STASHBOX_FANSDB_KEY>",
        "STASHBOX_PMV_KEY": "<STASHBOX_PMV_KEY>",
        "STASHBOX_JAVSTASH_KEY": "<STASHBOX_JAVSTASH_KEY>",
        "SB_USER_AGENT": "<SB_USER_AGENT>",
        "SB_MIN_INTERVAL_MS": "<SB_MIN_INTERVAL_MS>",
        "SB_TIMEOUT_MS": "<SB_TIMEOUT_MS>",
        "SB_MAX_RETRIES": "<SB_MAX_RETRIES>",
        "SB_CACHE_TTL_MS": "<SB_CACHE_TTL_MS>",
        "SB_CACHE_MAX_ENTRIES": "<SB_CACHE_MAX_ENTRIES>",
        "SB_LOG_LEVEL": "<SB_LOG_LEVEL>"
      }
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

mcp stashbox in other clients

mcp stashbox MCP server