# Agentic MCP

> Agentic MCP is an open-source MCP server for developer tools. Local MCP server giving ChatGPT Developer Mode and other clients coding tools for repos. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://hugoramos.dev
- **Repository:** https://github.com/hugolsramos01-bit/mcp-agentic-server
- **MCP Registry name:** io.github.hugolsramos01-bit/mcp-agentic-server
- **Categories:** developer tools
- **Listing updated:** 2026-11-17

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/agentic-mcp
