# CodexGuild

> CodexGuild is a freemium MCP server for security. Release changes, error fixes and scanned skills so coding agents fit your stack versions. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $10 a month
- **Platforms:** CLI, API
- **Website:** https://codexguild.com/docs/mcp
- **MCP Registry name:** com.codexguild/codexguild
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-15

## About

CodexGuild reads your lockfiles to learn the exact library and runtime versions you run, then tells the agent what changed since the model's training cutoff. The sync tool finds deprecated APIs in your own code with file, line and replacement, and looks up known fixes for errors instead of letting the agent guess.

The local npm package adds offline tools that ship inside it: scanning installed skills, pattern-scanning code for vulnerability classes, reviewing GitHub workflows that run coding agents, linting AGENTS.md or CLAUDE.md, scoring repository readiness and finding where recent sessions lost time. The remote endpoint serves 25 tools over Streamable HTTP for cloud agents and needs an agent key.

Plans meter daily API calls per account, shared by all your agents. The docs say usage, initialize and tools/list are free, and that hitting a limit returns HTTP 429 without blocking reads.

## Features

- **Stack-aware freshness:** Detects versions from lockfiles and reports breaking changes since the model cutoff.
- **Error lookup:** Returns known fixes verified for the versions your project runs.
- **Offline skill and code scans:** Scans installed skills and your code locally; nothing is uploaded.
- **Instruction file linting:** Checks AGENTS.md, CLAUDE.md and similar files for size, secrets and injection.
- **Local or remote use:** Run via npx or connect to a hosted Streamable HTTP endpoint.

## Good for

- Make a coding agent use APIs valid for your installed versions
- Audit skills before installing them
- Look up a known fix for a stubborn error
- Check a repository's agent readiness and workflow security

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http codexguild https://api.codexguild.com/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.codexguild.com/v1/mcp
```

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

```json
{
  "mcpServers": {
    "codexguild": {
      "url": "https://api.codexguild.com/v1/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "codexguild": {
      "type": "http",
      "url": "https://api.codexguild.com/v1/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "codexguild": {
      "serverUrl": "https://api.codexguild.com/v1/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "codexguild": {
      "type": "http",
      "url": "https://api.codexguild.com/v1/mcp"
    }
  }
}
```

## Tools

- `codexguild_sync`: Detects your stack and versions and runs the remote sync.
- `codexguild_advise`: Detects instruction files before asking for proposals.
- `codexguild_freshness`: Reports what changed for a topic since a given date.
- `codexguild_usage`: Shows remaining budget; always free.
- `codexguild_scan_skills`: Scans installed skills offline.
- `codexguild_scan_code`: Finds deprecated or removed APIs in your code.
- `codexguild_scan_security`: Pattern-scans your code for vulnerability classes.
- `codexguild_scan_workflows`: Reviews GitHub workflows that run coding agents.
- `codexguild_lint_instructions`: Lints AGENTS.md, CLAUDE.md and similar files.
- `codexguild_readiness`: Scores repository readiness for an agent from 0 to 100.
- `codexguild_coach`: Finds where recent agent sessions lost time.

## FAQ

### Do I need a key?

Yes. An agent key (cgk_…) is required and free to create.

### Does it read my source code?

Projects are dependency lists; the pricing page says only package files and lockfiles are read, never source.

### Are limits per agent?

No, they are per account and shared by all your agents.

### Which clients work?

Claude Code, Codex, Cursor, Gemini CLI, OpenCode and other MCP-capable harnesses.

### Is CodexGuild free?

CodexGuild has a free plan, with paid plans for more usage or features. Paid plans start at $10 a month.

### How do I add CodexGuild to Claude Code?

Run this command in your terminal: claude mcp add --transport http codexguild https://api.codexguild.com/v1/mcp

### What are the best alternatives to CodexGuild?

The closest alternatives to CodexGuild 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/codexguild
