Guard Core MCP
An MCP server that lets AI coding agents answer questions about the Guard security ecosystem from the libraries themselves, instead of from memory.
Covers fastapi-guard,
guard-core and
guard-agent.
Status: 0.0.1, early scaffold. Only the
versionstool is implemented. The config, documentation and detection tools described below are in progress.
Why
Your agent can already read the docs. What it cannot do is tell you that the redis_failopen
in your config is silently doing nothing because the real field is redis_fail_open, or that
the flag you are reaching for did not exist until guard-core 3.5.0, or whether a given request
would actually be blocked and by which pattern.
This server answers those from the installed package: real pydantic validation, real field metadata, and the real detection engine.
Install
Install it into your project's environment, not as an isolated tool:
uv add --dev guard-core-mcp
claude mcp add guard-core -- uv run guard-core-mcp
uvx guard-core-mcp will start, but an isolated environment contains no guard-core or
fastapi-guard for it to introspect, so it can only answer from bundled documentation. Running
it inside your own environment is what makes the answers match the versions you actually ship.
Tools
| Tool | Answers |
|---|---|
versions |
Which Guard libraries are installed here, and at what version |
validate_config |
Is this config valid — including typo'd keys pydantic silently ignores |
config_fields |
What is this setting, what does it default to, does a setting for X exist |
search_docs |
Where do the docs cover this |
get_doc |
The full text of one documentation page |
check_payload |
Would this request be blocked, and by which pattern |
Licence
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file guard_core_mcp-0.0.1.tar.gz.
File metadata
- Download URL: guard_core_mcp-0.0.1.tar.gz
- Upload date:
- Size: 168.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ed3fbc19bc412450b88632a0136535316be187716f74d46f6045a6f95c7ca5eb
|
|
| MD5 |
80a1bd25b82759485ea5a1e3e5906cbf
|
|
| BLAKE2b-256 |
6b8c2a9087cdf3f571b4ce29450d592b65bb8b5657d021739e1a30f078b94fdc
|
File details
Details for the file guard_core_mcp-0.0.1-py3-none-any.whl.
File metadata
- Download URL: guard_core_mcp-0.0.1-py3-none-any.whl
- Upload date:
- Size: 4.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1e247a14543588ea4e780d7f54027f0face811bcbb3ce36f0c924d4cf0eb7665
|
|
| MD5 |
68e1ee4c188b14b36e6e6b9cc4068e71
|
|
| BLAKE2b-256 |
2175f0b41dbb84b7d0cd0a50dc7a6747bfe6bf8561839e81d3a3332efce01e6b
|
