Skip to content
MCP server

AXF

Turn a repository's recurring build and test routines into inspectable agent capabilities

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
2.1.4
Listing updated
today

Similar MCP servers

About AXF

AXF is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

AXF (Agent eXoskeleton Framework) starts from a common problem: an agent can read code but must rediscover how a repository is built, tested and diagnosed each session. You fit the repository once, and later agents discover a named capability, inspect its contract, then run it.

A capability declares its arguments, output modes, side effects, lifecycle, policies and execution target. AXF does not replace a provider's commands; it projects the parts that need a clearer contract. The README is blunt about fit: it suggests a read-only assessment prompt returning adopt, pilot, defer or not a fit, and says it suits repositories with repeated local ceremony.

The MCP server exposes exactly one tool, axf, routing into the workspace's capabilities. It installs from npm as @smartergpt/axf, ships axf and axf-mcp, is Apache-2.0 and is marked alpha.

Install

Run in a terminal

claude mcp add axf -- npx -y @smartergpt/axf

Add to claude_desktop_config.json

{
  "mcpServers": {
    "axf": {
      "command": "npx",
      "args": [
        "-y",
        "@smartergpt/axf"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "axf": {
      "command": "npx",
      "args": [
        "-y",
        "@smartergpt/axf"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "axf": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@smartergpt/axf"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "axf": {
      "command": "npx",
      "args": [
        "-y",
        "@smartergpt/axf"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "axf": {
      "command": "npx",
      "args": [
        "-y",
        "@smartergpt/axf"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • AXF_PROJECT_ROOTCanonical AXF project root for manifest and adapter discovery. Defaults to current working directory when no marker is found.
  • AXF_EXECUTION_ROOTCanonical AXF execution root for runtime cwd and caller-facing execution. Defaults to current working directory.
  • AXF_WORKSPACELegacy alias that sets both the AXF project root and execution root.
  • AXF_REGISTRY_WORKSPACELegacy alias for AXF_PROJECT_ROOT.
  • AXF_EXECUTION_WORKSPACELegacy alias for AXF_EXECUTION_ROOT.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

axf
Single entry that routes to the workspace's AXF capabilities.

What it does

Discover, inspect, run
Three steps over named capabilities.
Declared contracts
Arguments, side effects and policies are explicit.
Workspace roots
Separates project root from execution root.
Fit assessment
A read-only prompt judges adoption.
Single MCP tool
One tool routes to every capability.
Codex check
axf integrate codex audits a package pin.

Good for

  • Give every agent the same validated route to run tests
  • Replace scattered scripts with inspected capabilities
  • Decide whether a repository is worth fitting
  • Read the contract of an operation before running

Pricing

Open source

Apache-2.0

AXF FAQ

What licence?

Apache-2.0 for 2.1.5; earlier releases keep their terms.

What status?

Alpha.

How many MCP tools?

One, named axf.

When is it not a fit?

When one obvious command covers the work.

Is AXF free?

Yes. AXF is open source, so you can use and self-host it for free.

How do I add AXF to Claude Code?

Run this command in your terminal: claude mcp add axf -- npx -y @smartergpt/axf

What are the best alternatives to AXF?

The closest alternatives to AXF are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers