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 connecting AI & ML tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-03-17 · ★ 17 · #67 OF 95 MAINTAINED AI & ML · VERIFIED 2026-08-25

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 #67 of 95 actively-maintained AI & ML servers as of 2026-08-25.
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-08-25, 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 · Git Courer · Densely

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