Skip to content
MCP server

Agentic MCP

Local MCP server giving ChatGPT Developer Mode and other clients coding tools for repos

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
1.8.2
Listing updated
today

About Agentic MCP

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

Agentic MCP is built by a data and software engineer in Recife, and is aimed at people who want ChatGPT Web, not only Claude or Cursor, to work on local code. The README's setup runs the server on port 7676, exposes it through an HTTPS tunnel such as ngrok, and adds it as a custom MCP app in ChatGPT's Developer Mode with a local OAuth prompt. For Claude Desktop, Cursor or other local clients it also runs over stdio with npx.

The tools cover structured, line-precise file editing, shell execution, Git worktrees, AST-based navigation and checkpoints. Access is limited to directories listed in AGENTIC_ALLOWED_ROOTS. The README is blunt that a managed Git worktree is not an operating-system sandbox: it does not restrict network access or subprocesses, so you should review what the model plans to run. It is an independent project, not affiliated with OpenAI, and the maintainer tested it with ChatGPT Plus.

Install

Run in a terminal

claude mcp add mcp-agentic-server --env AGENTIC_ALLOWED_ROOTS='<AGENTIC_ALLOWED_ROOTS>' -- npx -y mcp-agentic-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-agentic-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-agentic-server"
      ],
      "env": {
        "AGENTIC_ALLOWED_ROOTS": "<AGENTIC_ALLOWED_ROOTS>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-agentic-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-agentic-server"
      ],
      "env": {
        "AGENTIC_ALLOWED_ROOTS": "<AGENTIC_ALLOWED_ROOTS>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-agentic-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-agentic-server"
      ],
      "env": {
        "AGENTIC_ALLOWED_ROOTS": "<AGENTIC_ALLOWED_ROOTS>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp-agentic-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-agentic-server"
      ],
      "env": {
        "AGENTIC_ALLOWED_ROOTS": "<AGENTIC_ALLOWED_ROOTS>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp-agentic-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-agentic-server"
      ],
      "env": {
        "AGENTIC_ALLOWED_ROOTS": "<AGENTIC_ALLOWED_ROOTS>"
      }
    }
  }
}

Configuration

  • AGENTIC_ALLOWED_ROOTSComma-separated list of project directories that Agentic MCP may access.Required

What it does

ChatGPT Developer Mode
Connects ChatGPT Web to local repositories through a tunnelled MCP endpoint.
Structured editing
Line-precise file edits rather than whole-file rewrites.
Shell execution
Runs commands on your machine, so output and intent need review.
Git worktrees
Keeps changes in an isolated managed checkout away from the main repo.
Semantic navigation
AST-based code navigation plus checkpoints.
Allowed roots
AGENTIC_ALLOWED_ROOTS restricts which project directories can be touched.

Good for

  • Use a ChatGPT Plus plan as a local coding assistant
  • Let an agent edit code in an isolated Git worktree
  • Navigate a large repo by AST rather than grep
  • Run the same tools from Claude Desktop or Cursor over stdio

Pricing

Open source

Open source; ChatGPT plan limits apply when used through Developer Mode

Prices change. Check hugoramos.dev before you buy.

Agentic MCP FAQ

Does it need an OpenAI API key?

No. The README says model usage goes through your ChatGPT account and no OpenAI API key is required.

Is it sandboxed?

No. A Git worktree isolates checkouts but does not restrict network access or subprocesses.

How do I run it?

npx -y mcp-agentic-server@latest init, then serve, and tunnel port 7676 with ngrok; for stdio use npx -y mcp-agentic-server@latest stdio.

Is it official?

No. It is an independent open-source project not affiliated with OpenAI.

Is Agentic MCP free?

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

How do I add Agentic MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-agentic-server --env AGENTIC_ALLOWED_ROOTS='<AGENTIC_ALLOWED_ROOTS>' -- npx -y mcp-agentic-server

What are the best alternatives to Agentic MCP?

The closest alternatives to Agentic MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Agentic MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools