<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.

agentforge.sciscale.org · Quick start · npm

</div>

AgentForge MCP in action

agentforge-mcp is the Model Context Protocol server for AgentForge. 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, open API keys, and create one. The key is shown once — copy it.

2. Add it to your agent.

Claude Code:

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.):

{
  "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

Returns the refined prompt, plus its Quality Engine score and your remaining daily usage.

Free vs Pro

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.

The AgentForge web app

<div align="center">

→ Try it now at agentforge.sciscale.org

</div>

Paste a request, pick your target tool, copy the prompt — generation history and advanced modes included:

The web app in action

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

Develop

npm install
npm run build      # tsc -> dist/
node dist/index.js # runs on stdio

License

MIT — see 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>

_{agentforge-mcp is part of AgentForge — a SciScale studio product.}

</div>