Metadata-Version: 2.4
Name: manus-credit-optimizer
Version: 5.2.1
Summary: AI Credit Optimizer MCP Server — Save 30-75% on AI credits with ZERO quality loss. ~55% average savings across 53 adversarial scenarios. Successor to mcp-credit-optimizer.
Author-email: Rafael Silva <rafa.amaralsilva+pypi2@gmail.com>
License: MIT
Project-URL: Homepage, https://creditopt.ai
Project-URL: Repository, https://github.com/rafsilva85/credit-optimizer-v5
Project-URL: Documentation, https://github.com/rafsilva85/credit-optimizer-v5#readme
Project-URL: Issues, https://github.com/rafsilva85/credit-optimizer-v5/issues
Project-URL: Changelog, https://github.com/rafsilva85/credit-optimizer-v5/releases
Keywords: mcp,ai,credits,optimization,agent,claude,cursor,manus,model-context-protocol
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=2.0.0
Dynamic: license-file

[![Available on SkillFlow](https://raw.githubusercontent.com/rafsilva85/awesome-ai-skills/main/badges/skillflow-available.svg)](https://skillflow.builders)

# Credit Optimizer v5 for Manus AI

<!-- mcp-name: io.github.rafsilva85/credit-optimizer-v5 -->

> **Save 30-75% on Manus AI credits with zero quality loss.** ~55% average savings. Audited across 53 adversarial scenarios, 200+ tasks verified. Works as MCP server (free) or native Manus Skill ($9).

[![PyPI](https://img.shields.io/pypi/v/mcp-credit-optimizer.svg)](https://github.com/rafsilva85/credit-optimizer-v5)
[![PyPI Downloads](https://img.shields.io/pypi/dm/mcp-credit-optimizer.svg)](https://github.com/rafsilva85/credit-optimizer-v5)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)
[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io)
[![Stars](https://img.shields.io/github/stars/rafsilva85/credit-optimizer-v5?style=social)](https://github.com/rafsilva85/credit-optimizer-v5)

**Available on:** [PyPI](https://github.com/rafsilva85/credit-optimizer-v5) · [MCP Registry](https://registry.modelcontextprotocol.io) · [Smithery](https://smithery.ai/server/rafsilva85/credit-optimizer) · [GitHub](https://github.com/rafsilva85/credit-optimizer-v5) · [Landing Page](https://creditopt.ai)

---

## The Problem

Manus AI charges credits per task. Most users waste 30-75% of their credits because:

- Simple tasks run in Max mode when Standard would produce identical results
- Prompts contain redundant context that inflates token usage
- Tasks that could be batched are executed one by one
- Output formats are not optimized for the task type

**Credit Optimizer fixes all of this automatically.**

---

## How It Works

```
Your Prompt
    │
    ▼
┌──────────────────────────────────────────┐
│         Credit Optimizer v5              │
│                                          │
│  1. Intent Classification (12 categories)│
│  2. Complexity Scoring                   │
│  3. Model Routing (Standard vs Max)      │
│  4. Prompt Compression                   │
│  5. Batch Detection                      │
│  6. Context Hygiene                      │
│  7. Output Format Optimization           │
│                                          │
│  Result: Optimized strategy + savings %  │
└──────────────────────────────────────────┘
    │
    ▼
Same quality output, fewer credits
```

---

## Demo

```
> analyze_prompt("Build me a React dashboard with charts, auth, and database backend")

╔══════════════════════════════════════════════════════════════╗
║  CREDIT OPTIMIZER v5 — Analysis Report                      ║
╠══════════════════════════════════════════════════════════════╣
║                                                              ║
║  Intent:      code_generation (complex, multi-component)     ║
║  Model:       Max mode ✓ (correct for this complexity)       ║
║  Savings:     35-45% estimated                               ║
║  Quality:     0% loss                                        ║
║                                                              ║
║  Strategy: Split into 3 sequential tasks                     ║
║  ┌──────────────────────────────────────────────────────┐    ║
║  │ Task 1: Database schema + API routes (Standard)      │    ║
║  │ Task 2: Authentication flow (Standard)               │    ║
║  │ Task 3: React dashboard + charts (Max)               │    ║
║  └──────────────────────────────────────────────────────┘    ║
║                                                              ║
║  Optimizations applied:                                      ║
║  ✓ Model routing: Tasks 1-2 downgraded to Standard           ║
║  ✓ Batch detection: 3 focused tasks vs 1 monolithic          ║
║  ✓ Context hygiene: Removed redundant specifications         ║
║  ✓ Output format: Structured code blocks per component       ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝
```

```
> analyze_prompt("Translate this paragraph to Spanish")

╔══════════════════════════════════════════════════════════════╗
║  CREDIT OPTIMIZER v5 — Analysis Report                      ║
╠══════════════════════════════════════════════════════════════╣
║                                                              ║
║  Intent:      translation (simple)                           ║
║  Model:       Standard mode ✓ (Max unnecessary)              ║
║  Savings:     60-70% estimated                               ║
║  Quality:     0% loss                                        ║
║                                                              ║
║  Recommendation: Use Standard mode                           ║
║  Translation tasks produce identical quality in Standard.    ║
║  No splitting needed — single atomic task.                   ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝
```

---

## Real Results

| Metric | Value |
|--------|-------|
| Credit savings range | **30–75%** |
| Average savings (across all task types) | **~55%** |
| Quality loss | **0%** |
| Real tasks analyzed | 200+ |
| Adversarial test scenarios | 53 (all passing) |
| Vulnerabilities found & fixed | 12 |

---

## Quick Start

### Option 1: MCP Server (Free)

Works with Claude Desktop, Cursor, Windsurf, Copilot, and any MCP-compatible client.

```bash
# Install from PyPI (recommended)
pip install mcp-credit-optimizer
python -m mcp_credit_optimizer
```

Or install from source:

```bash
git clone https://github.com/rafsilva85/credit-optimizer-v5.git
cd credit-optimizer-v5
pip install -e .
python -m mcp_credit_optimizer
```

Add to your MCP config (`claude_desktop_config.json` or equivalent):

```json
{
  "mcpServers": {
    "credit-optimizer": {
      "command": "python",
      "args": ["-m", "mcp_credit_optimizer"]
    }
  }
}
```

### Option 2: Manus Skill (Native Integration)

The Manus Skill runs automatically on every task — no manual prompting needed.

**[Get the Manus Skill — $9 →](https://creditopt.ai)**

One-time payment. Lifetime updates. 30-day money-back guarantee.

---

## MCP Tools

| Tool | Description |
|------|-------------|
| `analyze_prompt` | Analyze a prompt and get optimization recommendations with estimated savings |
| `get_optimization_strategy` | Get detailed strategy with model routing, prompt compression, and batch detection |
| `get_golden_rules` | Get the 10 golden rules for credit-efficient Manus usage |

---

## Audit Results

All 53 test scenarios pass with zero quality degradation:

| Category | Scenarios | Quality Loss |
|----------|-----------|-------------|
| Code generation (Python, JS, React, SQL) | 12 | 0% |
| Creative writing (blog, marketing) | 8 | 0% |
| Data analysis (CSV, JSON, API) | 7 | 0% |
| Research (multi-source synthesis) | 6 | 0% |
| Translation & localization | 5 | 0% |
| Bug fixing & debugging | 5 | 0% |
| Documentation generation | 5 | 0% |
| Mixed-intent tasks | 5 | 0% |

---

## Why Pay When the MCP Server Is Free?

The **Manus Skill** gives you:

- **Auto-activation** — runs on every task without you remembering to use it
- **Native integration** — works inside Manus, not as an external tool
- **Priority updates** — get new optimization patterns first
- **One-time $9 payment** — no subscription, yours forever

> The MCP server saves you credits when you remember to use it.
> The Manus Skill saves you credits on **every single task** automatically.

---

## Community Feedback

> *"Excellent advice"* — [u/Business_Cheetah_689](https://reddit.com/r/ManusAI) on the optimization strategies

> *"This is exactly what I needed. Was burning through credits way too fast."* — Reddit user

---

## Contributing

Issues and PRs welcome! If you find a scenario where the optimizer reduces quality, please [open an issue](https://github.com/rafsilva85/credit-optimizer-v5/issues) with the prompt and expected output.

## License

MIT License — use it freely in personal and commercial projects.

---

<p align="center">
  <strong>Built by <a href="https://github.com/rafsilva85">Rafael Silva</a></strong><br>
  <a href="https://creditopt.ai">creditopt.ai</a> · <a href="https://rafaamaral.gumroad.com/l/credit-optimizer-v5">Gumroad</a> · <a href="https://github.com/rafsilva85/credit-optimizer-v5">GitHub</a>
</p>
