← MCP servers · smallcloudai

Refact

BLOCKgrade F · trust 37/100

AI Agent that handles engineering tasks end-to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result.

ai agentdeveloper toolsenterprisefine tuningon premopen sourceragself hosted

Overview

From the repository's own README, as read at the audited commit.

<a name="readme-top"></a><div align="center">  <picture>    <source media="(prefers-color-scheme: dark)" srcset="https://docs.refact.ai/_astro/logo-dark.CCzD55EA.svg">    <source media="(prefers-color-scheme: light)" srcset="https://docs.refact.ai/_astro/logo-light.CblxRz3x.svg">    <img alt="Refact logo" src="https://docs.refact.ai/_astro/logo-dark.CCzD55EA.svg" width="200">  </picture>  <h1 align="center">Refact</h1>  <p align="center">Open-source, local-first AI coding assistant for IDE chat, autonomous agent workflows, and tool-powered development.</p></div><div align="center">  <a href="https://github.com/smallcloudai/refact/stargazers"><img src="https://img.shields.io/github/stars/smallcloudai/refact?style=for-the-badge&color=blue" alt="GitHub stars"></a>  <a href="https://docs.refact.ai"><img src="https://img.shields.io/badge/documentation-blue?logo=googledocs&logoColor=FFE165&style=for-the-badge" alt="Documentation"></a>  <a href="https://github.com/smallcloudai/refact/issues"><img src="https://img.shields.io/badge/issues-github?style=for-the-badge" alt="GitHub issues"></a></div>> [!IMPORTANT]> This repository is kept as the legacy archive for the original Refact project and is no longer the active development home.> Ongoing development has moved to [JegernOUTT/refact](https://github.com/JegernOUTT/refact); please use that repository for new issues, pull requests, and future updates.> Refact Cloud has been retired. Read the announcement: [Refact Cloud is shutting down](https://refact.ai/blog/2026/refact-cloud-is-shutting-down/).## LicenseRefact is distributed under the BSD-3-Clause license. See the repository license for details.

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add refact-chat-js --env HF_TOKEN=${HF_TOKEN} --env OPENAI_API_KEY=${OPENAI_API_KEY} --env REFACT_TOKEN=${REFACT_TOKEN} -- npx -y [email protected]
claude-desktop
{
  "mcpServers": {
    "refact-chat-js": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "HF_TOKEN": "${HF_TOKEN}",
        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
        "REFACT_TOKEN": "${REFACT_TOKEN}"
      }
    }
  }
}

Exposed tools (12) 8 read · 3 write · 1 destructive

Blast radius: 1 tool can delete or overwrite. An agent that can be talked into calling a tool can be talked into calling this one.

ToolRiskDescription
DefinitionreadFind definition of a symbol in the project using AST
RepositoryreadRepository content
code-reviewreadReview code
commit_messagewriteGenerate a commit message
create_issuewriteCreate a GitHub issue
delete_repodestructiveDelete a repository
existing-skillreadExisting
local_skillreadA local project skill
my-pluginreadA useful plugin
my_skillreadExisting description
plugin_skillreadA plugin skill
reviewwriteRun review

Details

Source
smallcloudai/refact
npm
refact-chat-js@8.0.4
Transports
stdio · streamable-http
Credentials it reads
HF_TOKENOPENAI_API_KEYREFACT_TOKEN
License
BSD-3-Clause
Stars
3,542 · pushed 106d ago

Trust audit

Do not install this without reading the findings. The audit found something that could harm you or your machine.

LayerWhat it checksResult
L0Provenance & inventoryWARN
L1Static analysis of the codeFAIL
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfaceWARN
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (11 observation(s))
Network
declared (13 observation(s))
Shell
declared (6 observation(s))
Dependencies
not all pinned
Secrets in source
found

Findings (25)

CRITICALHard-coded secrets · secret.aws · CWE-798, CWE-321
refact-agent/engine/src/buddy/user_activity.rs:355
path: "src/AKIA1234567890ABCDEF/config.rs".to_string(),
CRITICALHard-coded secrets · secret.aws · CWE-798, CWE-321
refact-agent/engine/src/buddy/user_activity.rs:361
assert!(!path.contains("AKIA1234567890ABCDEF"));
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
plugins/vscode/assets/hl.min.js:133
}),!0),this.lastIndex=0}exec(e){this.matcherRe.lastIndex=this.lastIndex
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
plugins/vscode/assets/hl.min.js:143
this.rules.push([e,n]),"begin"===n.type&&this.count++}exec(e){
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
refact-agent/engine/src/integrations/integr_cmdline.rs:683
fn exec(message: &ChatMessage) -> &Value {
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
refact-agent/engine/src/integrations/integr_cmdline.rs:776
let exec = exec(&message);
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
refact-agent/engine/src/integrations/integr_cmdline.rs:816
let exec = exec(&message);
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHNetwork egress · net.tls_off · CWE-200, CWE-319
plugins/vscode/src/launchRust.ts:120
new_cmdline.push("--insecure");
Why it matters. certificate verification is disabled
Fix. leave verification on
HIGHHard-coded secrets · secret.db_uri · CWE-798, CWE-321
refact-agent/engine/src/yaml_configs/mcp_marketplace_index.json:1683
"RABBITMQ_URL": "amqp://guest:guest@localhost:5672"
MEDIUMInventory / provenance · inv.binary · CWE-1104
plugins/intellij/gradle/wrapper/gradle-wrapper.jar
gradle-wrapper.jar
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
MEDIUMNetwork egress · net.beacon_words · CWE-200, CWE-319
refact-agent/gui/src/features/Buddy/buddyWorldDirector.ts:436
speech: "Snack beacon detected.",
MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319
plugins/intellij/src/main/kotlin/com/smallcloud/refactai/lsp/LSPProcessHolder.kt:432
val startupUrl = URI("http://127.0.0.1:${newConfig.port}/")
MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319
plugins/intellij/src/main/kotlin/com/smallcloud/refactai/lsp/LSPProcessHolder.kt:576
InferenceGlobalContext.connection.get(URI("http://127.0.0.1:$port/v1/graceful-shutdown")).get()?.get()
MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319
plugins/intellij/src/main/kotlin/com/smallcloud/refactai/lsp/LSPProcessHolder.kt:652
return URI("http://127.0.0.1:${debugPort}/")
MEDIUMObfuscation / stealth · obf.base64_blob · CWE-506, CWE-94
refact-agent/gui/src/__fixtures__/chat.ts:888
"/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BST0ZJTEUAAQEAAAHIAAAAAAQwAABtbnRyUkdCIFhZWiAH4AABAAEAAAAAAABhY3NwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAA9tYAAQAAAADTLQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
MEDIUMObfuscation / stealth · obf.base64_blob · CWE-506, CWE-94
refact-agent/gui/src/__fixtures__/some_chrome_screenshots.ts:63
"/9j/4AAQSkZJRgABAgAAAQABAAD/wAARCAGYAyADAREAAhEBAxEB/9sAQwAIBgYHBgUIBwcHCQkICgwUDQwLCwwZEhMPFB0aHx4dGhwcICQuJyAiLCMcHCg3KSwwMTQ0NB8nOT04MjwuMzQy/9sAQwEJCQkMCwwYDQ0YMiEcITIyMjIyMjIyMjIyMjIyMjIyMjIyMjI
MEDIUMObfuscation / stealth · obf.base64_blob · CWE-506, CWE-94
refact-agent/gui/src/__fixtures__/some_chrome_screenshots.ts:68
"/9j/4AAQSkZJRgABAgAAAQABAAD/wAARCAMfAXEDAREAAhEBAxEB/9sAQwAIBgYHBgUIBwcHCQkICgwUDQwLCwwZEhMPFB0aHx4dGhwcICQuJyAiLCMcHCg3KSwwMTQ0NB8nOT04MjwuMzQy/9sAQwEJCQkMCwwYDQ0YMiEcITIyMjIyMjIyMjIyMjIyMjIyMjIyMjI
MEDIUMObfuscation / stealth · obf.base64_blob · CWE-506, CWE-94
refact-agent/gui/src/__fixtures__/some_chrome_screenshots.ts:181
"/9j/4AAQSkZJRgABAgAAAQABAAD/wAARCAGYAyADAREAAhEBAxEB/9sAQwAIBgYHBgUIBwcHCQkICgwUDQwLCwwZEhMPFB0aHx4dGhwcICQuJyAiLCMcHCg3KSwwMTQ0NB8nOT04MjwuMzQy/9sAQwEJCQkMCwwYDQ0YMiEcITIyMjIyMjIyMjIyMjIyMjIyMjIyMjI
MEDIUMObfuscation / stealth · obf.base64_blob · CWE-506, CWE-94
refact-agent/gui/src/__fixtures__/some_chrome_screenshots.ts:198
"/9j/4AAQSkZJRgABAgAAAQABAAD/wAARCAMfAXEDAREAAhEBAxEB/9sAQwAIBgYHBgUIBwcHCQkICgwUDQwLCwwZEhMPFB0aHx4dGhwcICQuJyAiLCMcHCg3KSwwMTQ0NB8nOT04MjwuMzQy/9sAQwEJCQkMCwwYDQ0YMiEcITIyMjIyMjIyMjIyMjIyMjIyMjIyMjI
MEDIUMObfuscation / stealth · obf.homoglyph · CWE-506, CWE-94
refact-agent/engine/src/buddy/chat_reactions.rs:1635
let analysis = "please debug ProjectΔ import while keeping the identifier private";
MEDIUMObfuscation / stealth · obf.homoglyph · CWE-506, CWE-94
refact-agent/engine/src/buddy/chat_reactions.rs:1636
let generated = "Tiny alarm: ProjectΔ import is doing suspicious parkour.";
MEDIUMObfuscation / stealth · obf.homoglyph · CWE-506, CWE-94
refact-agent/engine/src/buddy/chat_reactions.rs:1641
assert!(!text.to_lowercase().contains("projectδ import"));
MEDIUMHard-coded secrets · secret.generic · CWE-798, CWE-321
docs/src/components/Search.astro:18
apiKey: "2bae895dcb109e0a9b87ee935c121c85",
MEDIUMHard-coded secrets · secret.generic · CWE-798, CWE-321
refact-agent/engine/src/buddy/tests.rs:1294
token: "ghp_AbCdEfGhIj1234567890".to_string(),
MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59
delete_repo
Why it matters. 1 tool(s) can delete or overwrite
Fix. prefer a read-only mode or scoped tokens; the page states the blast radius

Gates applied: critical_finding, no_behavioural_pass.

Audited 2026-09-14 · audit v0.4.0 · source sha 7f8594f70b4a · full audit: observations/trust-audit/mcp-server/smallcloudai__refact.json · Report an issue or request a re-scan

Audit history

DateSourceVerdictGradeScoreChange
2026-09-147f8594f70b4aBLOCKF37first audit

Alternatives

Other servers in the same categories, safer ones first.

Questions

What is the Refact MCP server?

AI Agent that handles engineering tasks end-to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result.

What tools does Refact expose?

12 in total: 8 read-only, 3 that write, and 1 that can delete or overwrite (delete_repo). Every one is listed on this page with its risk.

Is Refact safe to connect to an agent?

No — not without reading the findings first. The audit graded it F (37/100) and found 9 critical or high issues in the source. Each one is listed on this page with the file and line it is on. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.

What credentials does Refact need?

It reads HF_TOKEN, OPENAI_API_KEY and REFACT_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does Refact run?

It speaks stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as refact-chat-js at 8.0.4.

How current is this page?

The grade is for one exact copy of the source (7f8594f70b4a), read on 2026-09-14. The repository is watched and re-audited when it changes.

Provenance: OBSERVED · read 2026-09-14 · job trust-audit-2026-09-14