Promptheus MCP Server

by abhichandra21io.github.abhichandra21/promptheusv0.3.1

AI-powered prompt refinement with adaptive questioning and multi-provider support (6+ LLM backends)

17Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale8mo ago

Install Promptheus MCP server

claude mcp add promptheus -e GOOGLE_API_KEY='<google-api-key>' -e ANTHROPIC_API_KEY='<anthropic-api-key>' -e OPENAI_API_KEY='<openai-api-key>' -e GROQ_API_KEY='<groq-api-key>' -e QWEN_API_KEY='<qwen-api-key>' -e GLM_API_KEY='<glm-api-key>' -- uvx promptheus

{
  "mcpServers": {
    "promptheus": {
      "command": "uvx",
      "args": [
        "promptheus"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GROQ_API_KEY": "<groq-api-key>",
        "QWEN_API_KEY": "<qwen-api-key>",
        "GLM_API_KEY": "<glm-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "promptheus": {
      "command": "uvx",
      "args": [
        "promptheus"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GROQ_API_KEY": "<groq-api-key>",
        "QWEN_API_KEY": "<qwen-api-key>",
        "GLM_API_KEY": "<glm-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "promptheus": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "promptheus"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GROQ_API_KEY": "<groq-api-key>",
        "QWEN_API_KEY": "<qwen-api-key>",
        "GLM_API_KEY": "<glm-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "promptheus": {
      "command": "uvx",
      "args": [
        "promptheus"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GROQ_API_KEY": "<groq-api-key>",
        "QWEN_API_KEY": "<qwen-api-key>",
        "GLM_API_KEY": "<glm-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GOOGLE_API_KEY	—	yes	Google Gemini API key (optional, at least one provider required)
ANTHROPIC_API_KEY	—	yes	Anthropic Claude API key (optional, at least one provider required)
OPENAI_API_KEY	—	yes	OpenAI API key (optional, at least one provider required)
GROQ_API_KEY	—	yes	Groq API key (optional, at least one provider required)
QWEN_API_KEY	—	yes	Alibaba Qwen API key (optional, at least one provider required)
GLM_API_KEY	—	yes	Zhipu GLM API key (optional, at least one provider required)
PROMPTHEUS_PROVIDER	—	—	Override provider selection (gemini, anthropic, openai, groq, qwen, glm)
PROMPTHEUS_MODEL	—	—	Override model selection for the chosen provider

Freshness

Stale — last maintenance signal 8mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-02-06 · 8mo ago · GitHub
Latest release
2026-01-07 · 9mo ago · GitHub · v0.3.2
Package published
no data · npm/PyPI
Registry entry updated
2025-12-10 · 10mo ago · official registry · v0.3.1

FAQ

›How do I install the Promptheus MCP server in Claude Code?

Run: claude mcp add promptheus -e GOOGLE_API_KEY='<google-api-key>' -e ANTHROPIC_API_KEY='<anthropic-api-key>' -e OPENAI_API_KEY='<openai-api-key>' -e GROQ_API_KEY='<groq-api-key>' -e QWEN_API_KEY='<qwen-api-key>' -e GLM_API_KEY='<glm-api-key>' -- uvx promptheus. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Promptheus require an API key?

Yes. It expects GOOGLE_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, GROQ_API_KEY, QWEN_API_KEY, GLM_API_KEY, of which 6 are secrets.

›Can I use Promptheus as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Promptheus in the official MCP registry?

Yes, as io.github.abhichandra21/promptheus.