MCP.Market

Promptheus MCP server

by abhichandra21·io.github.abhichandra21/promptheus·v0.3.1·17 stars
No reviews yet

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

C66/100grade C
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
C66/100

full report

Adoption
Growing

17 stars22 downloads/wk

Reviews

Write one

Nobody has reviewed Promptheus yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Promptheus tools (5)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • list_models

    List available models from configured AI providers.

  • list_providers

    List all configured AI providers and their status.

  • refine_prompt

    Refine a user prompt using AI-powered prompt engineering.

  • tweak_prompt

    Make a specific modification to an existing prompt.

  • validate_environment

    Validate environment configuration and optionally test API connections.

Public scan report

scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it

no findings
  • Code scan45 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 198 days ago4/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 66/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Promptheus compares

Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
66/100
higher than 28% of 4,460 AI and agents servers
Tools
5
the typical AI and agents server has 6
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
17
more than 88% of 2,711 AI and agents servers
Downloads a week
22
more than 8% of 1,538 AI and agents servers with a package

What its tools let an agent do: 5 read

Install Promptheus in Claude Code, Cursor or VS Code

claude mcp add promptheus -- uvx promptheus
Add to Cursor

What the publisher says

From the Promptheus repository's README, as published. We do not edit it. Read it on GitHub

Promptheus

Refine and optimize prompts for LLMs

<!-- mcp-name: io.github.abhichandra21/promptheus -->

Quick Start

pip install promptheus
# Interactive session
promptheus

# Single prompt
promptheus "Write a technical blog post"

# Skip clarifying questions
promptheus -s "Explain Kubernetes"

# Use web UI
promptheus web

Python library usage

from promptheus import refine_prompt

result = refine_prompt("Write a technical blog post", skip_questions=True)
print(result["refined_prompt"])

If you're already in an async application (e.g., FastAPI), call refinepromptasync instead of the sync helper.

What is Promptheus?

Promptheus analyzes your prompts and refines them with:

  • Adaptive questioning: Smart detection of what information you need to provide
  • Multi-provider support: Works with Google, OpenAI, Anthropic, Groq, Qwen, and more
  • Interactive refinement: Iteratively improve outputs through natural conversation
  • Session history: Automatically track and reuse past prompts
  • CLI and Web UI: Use from terminal or browser

Supported Providers

OpenRouter integration in Promptheus is optimized around the openrouter/auto routing model:

  • Model listing is intentionally minimal: Promptheus does not expose your full OpenRouter account catalog.
  • You can still specify a concrete model manually with OPENROUTER_MODEL or --model if your key has access.

Core Features

🧠 Adaptive Task Detection Automatically detects whether your task needs refinement or direct optimization

⚡ Interactive Refinement Ask targeted questions to elicit requirements and improve outputs

📝 Pipeline Integration Works seamlessly in Unix pipelines and shell scripts

🔄 Session Management Track, load, and reuse past prompts automatically

📊 Telemetry & Analytics Anonymous usage and performance metrics tracking for insights (local storage only, can be disabled)

🌐 Web Interface Beautiful UI for interactive prompt refinement and history management

Configuration

Create a .env file with at least one provider API key:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Promptheus: common questions

Is Promptheus MCP server safe?
With care: it is graded C, so read the findings first (66/100). Read the Promptheus safety report
How do I install Promptheus?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Promptheus need an API key?
Yes. The registry entry asks for GOOGLE_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, GROQ_API_KEY and 2 more.
Is Promptheus maintained?
The last commit was 232 days ago (2026-03-17). The latest release is v0.3.1.
What can I use instead of Promptheus?
Servers from other publishers that do the same job: three.ws Brain MCP server, Claude Prompts MCP server and LLM Sandbox MCP server.
How does Promptheus compare with other AI and agents MCP servers?
safety score 66/100 (higher than 28% of 4,460 AI and agents servers); tools 5 (the typical AI and agents server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Promptheus

Same job from other publishers: the closest match first, then the best rated.

  • three.ws Brain
    List LLM providers and run chat completions through the three.ws multi-provider router.
    B
  • Claude Prompts
    Reusable prompt templates, multi-step workflow chains, and quality gates for any MCP client.
    A
  • LLM Sandbox
    Securely run LLM-generated code in isolated containers across 7 languages and 3 container backends.
    A
  • PaperBanana
    Generate academic diagrams and statistical plots from text using multi-agent AI.
    A
  • Agent-Native Analytics
    Agent-Native Amplitude/Mixpanel - connect data sources, prompt for charts
    A