# AXF

AXF exposes repository capabilities through MCP so agents can discover, inspect, and run the same project-specific routes. It fits repeated build, test, and validation work.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: SmarterGPT
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SmarterGPT/axf
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/axf

## What it does

AXF acts as a control layer between an agent and repository operations. A capability can declare its inputs, output mode, side effects, policies, lifecycle, and execution target. The agent can inspect that contract before running it instead of reconstructing the procedure from scattered scripts and instructions.

The npm package includes the `axf` CLI and the `axf-mcp` stdio server. You can use `axf doctor`, `axf list --compact`, `axf inspect`, and `axf run` from the command line; MCP clients can start the server through `npx`. AXF also separates project-root discovery from the execution directory.

AXF is currently alpha. An empty directory without an `axf.workspace.json` marker has no capabilities, so the workspace and root settings matter when you connect it to a project.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `AXF_PROJECT_ROOT`, `AXF_EXECUTION_ROOT`, `AXF_WORKSPACE`, `AXF_REGISTRY_WORKSPACE`, `AXF_EXECUTION_WORKSPACE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env AXF_PROJECT_ROOT=<AXF_PROJECT_ROOT> --env AXF_EXECUTION_ROOT=<AXF_EXECUTION_ROOT> --env AXF_WORKSPACE=<AXF_WORKSPACE> --env AXF_REGISTRY_WORKSPACE=<AXF_REGISTRY_WORKSPACE> --env AXF_EXECUTION_WORKSPACE=<AXF_EXECUTION_WORKSPACE> --transport stdio axf -- npx -y @smartergpt/axf
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add axf --env AXF_PROJECT_ROOT=<AXF_PROJECT_ROOT> --env AXF_EXECUTION_ROOT=<AXF_EXECUTION_ROOT> --env AXF_WORKSPACE=<AXF_WORKSPACE> --env AXF_REGISTRY_WORKSPACE=<AXF_REGISTRY_WORKSPACE> --env AXF_EXECUTION_WORKSPACE=<AXF_EXECUTION_WORKSPACE> -- npx -y @smartergpt/axf
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "axf": {
            "command": "npx",
            "args": [
                "-y",
                "@smartergpt/axf"
            ],
            "env": {
                "AXF_PROJECT_ROOT": "<AXF_PROJECT_ROOT>",
                "AXF_EXECUTION_ROOT": "<AXF_EXECUTION_ROOT>",
                "AXF_WORKSPACE": "<AXF_WORKSPACE>",
                "AXF_REGISTRY_WORKSPACE": "<AXF_REGISTRY_WORKSPACE>",
                "AXF_EXECUTION_WORKSPACE": "<AXF_EXECUTION_WORKSPACE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "axf": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@smartergpt/axf"
            ],
            "env": {
                "AXF_PROJECT_ROOT": "<AXF_PROJECT_ROOT>",
                "AXF_EXECUTION_ROOT": "<AXF_EXECUTION_ROOT>",
                "AXF_WORKSPACE": "<AXF_WORKSPACE>",
                "AXF_REGISTRY_WORKSPACE": "<AXF_REGISTRY_WORKSPACE>",
                "AXF_EXECUTION_WORKSPACE": "<AXF_EXECUTION_WORKSPACE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e AXF_PROJECT_ROOT=<AXF_PROJECT_ROOT> -e AXF_EXECUTION_ROOT=<AXF_EXECUTION_ROOT> -e AXF_WORKSPACE=<AXF_WORKSPACE> -e AXF_REGISTRY_WORKSPACE=<AXF_REGISTRY_WORKSPACE> -e AXF_EXECUTION_WORKSPACE=<AXF_EXECUTION_WORKSPACE> axf npx -y @smartergpt/axf
```
Replace <…> with your own values

## When to use it
- discover repository-specific capabilities
- inspect an operation before execution
- run project checks through one contract
- preserve local build and validation routes

## Example prompts
- List the capabilities for this repository and recommend the route for validation.
- Inspect the `check` capability, then run it with the required arguments.
- Run `axf doctor` and show the compact registry with `axf list --compact`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md