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 the whole family: the Python trio (fastapi-guard, guard-core, guard-agent) by live introspection, and the Go, TypeScript, PHP and Rust engines, their twenty framework adapters, their telemetry agents, and the guard-core-app SaaS ingestion contract from a verified registry and knowledge corpus.
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. It also answers the cross-language questions the libraries cannot answer: which package guards a Gin, Fastify, Laravel or Rocket app, whether it is tagged or still path-dependent, how to wire its telemetry agent, and what response codes the SaaS ingest endpoint returns.
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 |
ecosystem |
The full registry matrix: 5 languages, engines, adapters, agents, conformance, SaaS contract |
adapter_setup |
Install plus a verified minimal integration for one adapter (e.g. go + gin) |
wire_agent |
How to set up the telemetry agent for a language, including the ingestion contract |
The ecosystem tools are pure data, so they work everywhere, with or without the Python libraries installed. Every quick-start snippet is copied verbatim from the sibling repo READMEs, and release_status tells you honestly whether a package is published, tagged, or still untagged (source, main, or path dependency only).
ChatGPT plugin
The same tools are also served remotely at https://mcp.guard-core.com/mcp and packaged as a ChatGPT plugin: sign in with a guard-core account, and ChatGPT can validate configs, search the docs and run payloads through the hosted detection engine (the latest published releases, not your local versions). The packaging lives in plugin/, the hosted server in guard_core_mcp.hosting, and the full story (env vars, Docker image, developer-mode test loop, submission checklist) in the ChatGPT plugin guide.
Licence
MIT
1 maintainer
Metadata
1 maintainer
Release files for guard-core-mcp 1.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| guard_core_mcp-1.4.1.tar.gz | 861.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| guard_core_mcp-1.4.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / guard_core_mcp-1.4.1.tar.gz
| Download URL | guard_core_mcp-1.4.1.tar.gz |
|---|---|
| Size | 861.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b9f3c506cdaac9430b8c31a4df7489bf6b3097b6436a02b134cabac6e14818b2
|
|
BLAKE2b-256 checksum How to use checksums |
1664bc572a524258c7f6f8bc8a9c7281f39cf3aec1398e705081c0dacfe87168
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
Release files / guard_core_mcp-1.4.1-py3-none-any.whl
| Download URL | guard_core_mcp-1.4.1-py3-none-any.whl |
|---|---|
| Size | 696.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6efe26e115ab1e0d85b913565644ac9ab3898cbea42817cdca0ece3970eb5d82
|
|
BLAKE2b-256 checksum How to use checksums |
e6243e7884fce608da4ac8dd574dc8291a718af02a793129ecaa9c8d607675ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
