Metadata-Version: 2.4
Name: rulestamp-mcp-config-guard
Version: 1.0.8
Summary: Reads .mcp.json / .vscode/mcp.json / claude_desktop_config.json while you edit it and marks the lines that hand an AI agent more than you meant - unpinned servers, literal credentials, plaintext trans (bundled Node.js runtime)
Author-email: Rulestamp <support@getreadystack.com>
License: Proprietary - see LICENSE.txt
Project-URL: Homepage, https://getreadystack.com/tools/mcp-config-guard?ref=pypi
Project-URL: Documentation, https://getreadystack.com/tools/mcp-config-guard?ref=pypi
Project-URL: Support, https://getreadystack.com/support
Keywords: mcp,model context protocol,ai agent,security,lint,json,supply chain,secrets
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: nodejs-wheel-binaries>=20
Dynamic: license-file

# MCP Config Guard - agent config lint

> Runs the same checker as our npm package on a Node.js runtime that pip installs for you (`nodejs-wheel-binaries`) - no system Node.js needed. Your files are checked locally.

Reads .mcp.json / .vscode/mcp.json / claude_desktop_config.json while you edit it and marks the lines that hand an AI agent more than you meant - unpinned servers, literal credentials, plaintext transport, whole-home filesystem roots. 23 rules, offline, no server is ever started.

## Install

```
mcp-config-guard file
```

Node 18+. The same 23 rules as the VS Code extension, from a terminal or CI.

## Free

- Check the MCP config file you have open against all 23 rules - the line number, one sentence on what goes wrong, and the line that replaces it - offline, no key, no limit.
- `--rules` lists every rule

## With a licence ($29 once)

- Scale and hand-off: one sweep over every MCP config in the workspace and in the client config folders, a dated CSV/JSON/HTML report, and machine-readable output a CI step can fail on.

```
mcp-config-guard --dir ./templates --report html --out report.html
```

Upwork lists cybersecurity developers at a $60 median hourly rate, $40-$90 typical (Sept 2026).

## Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

```json
{ "mcpServers": { "mcp-config-guard": { "command": "mcp-config-guard", "args": ["--mcp"] } } }
```

Tools: `check_text` and `check_file` (free) · `check_dir` (licence). The agent gets every finding with the line number.

## Use in CI

```yaml
- name: MCP Config Guard - agent config lint
  run: pip install rulestamp-mcp-config-guard && mcp-config-guard --dir . --ci
```


The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.

[Get a licence](https://getreadystack.com/api/buy/cl/polar_cl_qkyHZkQQW6eB0rXgrKfDGviLlVixnkbP42q8B3h7YrG)


<!-- mcp config guard -->


## Install (PyPI)

```
pip install rulestamp-mcp-config-guard
mcp-config-guard --help
```
