AgentForge
Turn rough requests into rigorously structured prompts, for any coding agent.
Open source Open in the app JSON README (API)
About
Turn rough requests into rigorously structured prompts, for any coding agent.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- org.sciscale
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.4
- Stars
- 2
- Last push
- 2026-05-28T05:27:57Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:53
- Updated
- 2026-08-29 04:01:53
- Origin id
org.sciscale/agentforge-mcp
README
<div align="center">
<img src="assets/agentforge-mark.svg" alt="AgentForge" width="76" />
# agentforge-mcp
**Stop re-explaining what you want to your AI coding agent.**<br/>
Hand it one rough sentence — get back a structured, tool-tuned prompt
it can execute in one pass.
[](https://www.npmjs.com/package/agentforge-mcp)
[](./LICENSE)
[**agentforge.sciscale.org**](https://agentforge.sciscale.org) · [Quick start](#quick-start) · [npm](https://www.npmjs.com/package/agentforge-mcp)
</div>
`agentforge-mcp` is the [Model Context Protocol](https://modelcontextprotocol.io)
server for [AgentForge](https://agentforge.sciscale.org). One tool, one job: turn
a vague request into a sharp one.
## Why
You know the loop: you ask your coding agent for something, it misreads the half
you didn't spell out, you correct it, it breaks something else, you re-explain.
The fix isn't a smarter agent — it's a sharper *prompt*.
AgentForge does the prompt engineering for you. Give it
`"add a dark mode toggle that persists"` and it:
- **extracts the real requirements** — the edge cases, the acceptance criteria,
the things you'd have forgotten to mention;
- **formats for your specific agent** — Claude Code wants file:line references,
Cursor wants directives, Aider wants tight context;
- **quality-checks before returning** — every prompt is scored across 12
dimensions before it leaves the engine.
Harness engineering is having a moment — but prompt engineering matters *more*
in the coding-agent era, not less. Tested across **1,000+ real coding cases**,
projects with AgentForge in the loop reached a deployable state **147% faster**.
## Quick start
No install — it runs through `npx`.
**1. Get an API key.** Sign in at
[agentforge.sciscale.org](https://agentforge.sciscale.org), open **API keys**,
and create one. The key is shown once — copy it.
**2. Add it to your agent.**
Claude Code:
```sh
claude mcp add agentforge --env AGENTFORGE_API_KEY=af_your_key -- npx -y agentforge-mcp
```
Cursor / Windsurf / Claude Desktop — add to your MCP config
(`~/.cursor/mcp.json`, `~/.codeium/windsurf/mcp_config.json`, etc.):
```json
{
"mcpServers": {
"agentforge": {
"command": "npx",
"args": ["-y", "agentforge-mcp"],
"env": { "AGENTFORGE_API_KEY": "af_your_key" }
}
}
}
```
**3. Use it.** Ask your agent naturally — *"refine this with AgentForge, then
build it: add a dark mode toggle that persists."*
## The tool — `agentforge_refine_prompt`
| Argument | Default | |
|---|---|---|
| `request` | — | Your task in plain language (1–4000 chars). Rough is fine. |
| `target_tool` | `claude-code` | `claude-code`, `codex`, `cursor`, `aider`, `continue`, `windsurf`, `kimi`, `generic` |
| `style` | `plan-first` | `plan-first`, `direct-edit`, `explore-first` |
Returns the refined prompt, plus its Quality Engine score and your remaining
daily usage.
## Free vs Pro
| | Free | Pro |
|---|---|---|
| Refinements | 3 / day | Unlimited |
| Quality Engine | scored across 12 dimensions | scored **+ auto-refined until it passes ≥ 90** |
## Or use the web app
Don't want to wire up an MCP server at all? The same engine — same Quality
Engine, same per-account Pro — runs right in your browser at
**[agentforge.sciscale.org](https://agentforge.sciscale.org)**. No install, no
key, no config.
[](https://agentforge.sciscale.org)
<div align="center">
### [→ Try it now at agentforge.sciscale.org](https://agentforge.sciscale.org)
</div>
Paste a request, pick your target tool, copy the prompt — generation history and
advanced modes included:
## How it works
`agentforge-mcp` is a thin client — no engine logic ships in this package. Your
request goes to the AgentForge API, the hosted engine does the extraction,
formatting, and quality-checking, and the prompt comes back. The engine keeps
improving without you ever updating this package.
## Configuration
| Variable | Default | |
|---|---|---|
| `AGENTFORGE_API_KEY` | — | **Required.** Your API key. |
| `AGENTFORGE_API_URL` | `https://agentforge.sciscale.org/api/v1/refine` | Override the endpoint (rarely needed). |
## Develop
```sh
npm install
npm run build # tsc -> dist/
node dist/index.js # runs on stdio
```
## License
MIT — see [LICENSE](./LICENSE).
<br/>
<div align="center">
<a href="https://wow.sciscale.org">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/sciscale-white.png" />
<img src="assets/sciscale-ink.png" alt="SciScale studio" height="30" />
</picture>
</a>
<sub>**agentforge-mcp** is part of [AgentForge](https://agentforge.sciscale.org) — a [SciScale studio](https://wow.sciscale.org) product.</sub>
</div>