Atomadic Forge
by atomadictechcommunityv0.87.0
3
Atomadic Forge is an MCP server and CLI for analyzing Python, JavaScript, and TypeScript repositories, classifying symbols into a 5-tier architecture, and enforcing upward-only imports. It can also absorb messy repos into that layout, generate or evolve code with an LLM, and expose repository analysis and enforcement actions through MCP tools.
From the registry: Architecture compiler for AI code. 11 tools, 92 actions, 872 Lean4 proofs, 100/100 self-cert.
Install & configure
Prerequisites
- required
- requiredInstall Atomadic Forge from PyPIInstall the Forge CLI, which includes the MCP server.
https://pypi.org/project/atomadic-forge/$ pip install atomadic-forge - requiredObtain a Forge subscription API keyA paid Forge subscription key is required for MCP tool calls and resource reads. Read-only MCP handshake methods work without a key, but normal MCP usage requires authentication.
https://atomadic.tech/forge$ forge login
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `atomadic-forge` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Python 3.10+** — Atomadic Forge requires Python 3.10 or newer. (https://www.python.org/downloads/)
- **Install Atomadic Forge from PyPI** — Install the Forge CLI, which includes the MCP server. Run: `pip install atomadic-forge` (https://pypi.org/project/atomadic-forge/)
- **Obtain a Forge subscription API key** — A paid Forge subscription key is required for MCP tool calls and resource reads. Read-only MCP handshake methods work without a key, but normal MCP usage requires authentication. Run: `forge login` (https://atomadic.tech/forge)
Canonical MCP server config (stdio transport):
- command: `forge`
- args: ["mcp","serve","--project","<path-to-your-repo>"]
- required environment variables:
- `FORGE_API_KEY`: Forge subscription API key used to authorize MCP tools/calls and resource reads. Without this key, only read-only handshake methods work. (example: `<your-forge-api-key>`)
Note: The README shows the MCP server as a stdio JSON-RPC server. The simplest install path is via PyPI (`pip install atomadic-forge`). `forge login` can store credentials interactively, but for canonical MCP config use the `FORGE_API_KEY` environment variable. A hosted MCP endpoint is mentioned in pricing, but no canonical HTTP configuration details are provided, so only stdio config is extracted.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README shows the MCP server as a stdio JSON-RPC server. The simplest install path is via PyPI (`pip install atomadic-forge`). `forge login` can store credentials interactively, but for canonical MCP config use the `FORGE_API_KEY` environment variable. A hosted MCP endpoint is mentioned in pricing, but no canonical HTTP configuration details are provided, so only stdio config is extracted.
Tools (24)
recon
Analyze a repository and classify files/symbols by architecture tier and language
wire
Detect architecture violations such as upward import breaches
certify
Score or certify conformance of a repository or patch
enforce
Apply enforcement checks for architecture rules
audit_list
List audit findings or issues
auto_plan
Plan an automated absorption or restructuring run
auto_step
Run one step of the automated restructuring pipeline
auto_apply
Apply automated restructuring changes
context_pack
Package bounded repository context for AI use
preflight_change
Check a proposed change before applying it
score_patch
Score a code patch against architecture rules
select_tests
Choose relevant tests for a change
rollback_plan
Plan how to roll back changes
explain_repo
Explain repository structure and architecture
Environment variables
FORGE_API_KEYrequiredAPI key required for authenticated MCP tool calls and subscription verificationGEMINI_API_KEYrequiredKey for LLM-driven iterate/evolve generation flowsPrerequisites
- • Python 3.10+
Packages
atomadic-forge
pypiv0.87.0transport: stdio
Remote Endpoints
https://forge.atomadic.tech/mcp
type: streamable-http
Details
- Language
- Python
- License
- NOASSERTION
- Released
- May 11, 2026
- Last commit
- May 5, 2026
- Registry name
- io.github.atomadictech/atomadic-forge
Categories
Related Servers
Claude Flow
AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.
64.6k
Codebase Memory Mcp
Persistent codebase knowledge graph. Survives session restarts and context compaction.
31.9k
Serena
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
26.5k