Promptheus MCP Server

Refine and optimize prompts for LLMs If you're already in an async application (e.g., FastAPI), call refine_prompt_async instead of the sync helper. It runs locally over stdio via the published package.

People who work with prompt, codex and gemini and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-03-17 · ★ 17 · #71 OF 106 MAINTAINED AI & ML · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Promptheus

before you install - you'll need

Set GOOGLE_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, PROMPTHEUS_TELEMETRY_ENABLED, PROMPTHEUS_HISTORY_DIR before connecting.

Claude Code

claude mcp add abhichandra21-promptheus -- uvx promptheus

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "abhichandra21-promptheus": {
      "command": "uvx",
      "args": [
        "promptheus"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package promptheus - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.abhichandra21 is GitHub-verified and matches the repo owner

03 · What Promptheus can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.3.2 · 2026-01-07

Highlights · Critical Bug Fix: Fixed tweak formatting loss where prompts would lose markdown formatting and compress to 1/3 of original length · New Features: · Undo functionality for prompt tweaks - type undo to…

v0.3.0 · 2025-12-05

What's New · This release introduces a comprehensive telemetry system for tracking usage and performance metrics, along with MCP server improvements and critical bug fixes. · New Features · Telemetry System · Anonymous…

v0.2.4 · 2025-11-25

[0.2.4] - 2025-11-25 · Added · CI/CD Workflow Badges: Added status badges for GitHub Pages deployment, Docker builds, and package publishing · Web UI Guide: Comprehensive web interface documentation with interactive…

04 · Who maintains Promptheus

Promptheus is maintained by abhichandra21. It's the only MCP server we track from this author; the repo dates to Nov 2025.

05 · Facts

repository: github.com/abhichandra21/promptheus
website: https://github.com/abhichandra21/Promptheus
category: AI & ML - ranked #71 of 106 actively-maintained AI & ML servers as of 2026-09-18.
registry: io.github.abhichandra21/promptheus (active, first published 2025-12-10)
packages: pypi:promptheus

06 · Promptheus FAQ

What is Promptheus?

Is Promptheus still maintained?

Yes - as of 2026-09-18, its last commit was 2026-03-17. We re-verify nightly.

How do I install Promptheus?

Run `uvx promptheus`. The README documents 5 environment variables (GOOGLE_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY…) to set first. Set GOOGLE_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, PROMPTHEUS_TELEMETRY_ENABLED, PROMPTHEUS_HISTORY_DIR before connecting. You can also paste the ready-made client config above.

Does Promptheus run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Promptheus

Alternatives to Promptheus

Maintained AI & ML servers if Promptheus isn't the fit.

Pairs well with

Servers that cover what Promptheus doesn't - only shown when the pairing reason fits the companion.

More AI & ML MCP servers · Aegis - AI Agent Governance · Actenon Kernel · P2 Predict · Git Courer · Densely

More Python MCP servers · Waggle MCP · Airflow MCP Server · Google Search Console · Flux Pro · see all