AgentForge

Official registry Developer tools

Turn rough requests into rigorously structured prompts, for any coding agent.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package agentforge-mcp
Claude Code
claude mcp add agentforge -e 'AGENTFORGE_API_KEY=<your agentforge_api_key>' -e 'AGENTFORGE_API_URL=https://agentforge.sciscale.org' -- npx -y agentforge-mcp@0.1.4
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "agentforge": {
            "command": "npx",
            "args": [
                "-y",
                "agentforge-mcp@0.1.4"
            ],
            "env": {
                "AGENTFORGE_API_KEY": "<your agentforge_api_key>",
                "AGENTFORGE_API_URL": "https://agentforge.sciscale.org"
            }
        }
    }
}

Environment variables

  • AGENTFORGE_API_KEY required secret Your AgentForge API key from https://agentforge.sciscale.org/account/keys
  • AGENTFORGE_API_URL AgentForge API base URL (defaults to https://agentforge.sciscale.org)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. agentforge-mcp
  2. Why
  3. Quick start
  4. The tool — agentforge_refine_prompt
  5. Free vs Pro
  6. Or use the web app
  7. How it works
  8. Configuration
  9. Develop
  10. License

agentforge-mcp

Stop re-explaining what you want to your AI coding agent.

Hand it one rough sentence — get back a structured, tool-tuned prompt it can execute in one pass.

**agentforge.sciscale.org** · Quick start · npm

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

ArgumentDefault
request—Your task in plain language (1–4000 chars). Rough is fine.
target_toolclaude-codeclaude-code, codex, cursor, aider, continue, windsurf, kimi, generic
styleplan-firstplan-first, direct-edit, explore-first

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

Free vs Pro

FreePro
Refinements3 / dayUnlimited
Quality Enginescored across 12 dimensionsscored + 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. No install, no key, no config.

→ Try it now at agentforge.sciscale.org

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

VariableDefault
AGENTFORGE_API_KEY—Required. Your API key.
AGENTFORGE_API_URLhttps://agentforge.sciscale.org/api/v1/refineOverride the endpoint (rarely needed).

Develop

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

License

MIT — see LICENSE.

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

Frequently asked questions

What is AgentForge?

Turn rough requests into rigorously structured prompts, for any coding agent.

How do I install AgentForge?

It runs on your machine. In Claude Code: claude mcp add agentforge -e 'AGENTFORGE_API_KEY=<your agentforge_api_key>' -e 'AGENTFORGE_API_URL=https://agentforge.sciscale.org' -- npx -y agentforge-mcp@0.1.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does AgentForge need an API key?

Yes. It expects AGENTFORGE_API_KEY, which you set in its configuration.

Is AgentForge open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains AgentForge?

It is published by sciscale-studio. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.