Skip to main content

Guard Core MCP

PyPI version License: MIT CI Release CodeQL Docs Downloads

Website · Docs · Playground · Dashboard

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

mcp-name: io.github.Guard-Core/guard-core-mcp

Metadata

Release files for guard-core-mcp 1.4.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for guard-core-mcp 1.4.4
File Size Uploaded
guard_core_mcp-1.4.4.tar.gz 862.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for guard-core-mcp 1.4.4
File Interpreter ABI Platform
guard_core_mcp-1.4.4-py3-none-any.whl Python 3 none any Details

Total release size: 1.6 MB

Release files / guard_core_mcp-1.4.4.tar.gz

Download URL guard_core_mcp-1.4.4.tar.gz
Size 862.9 kB
Tags Source
SHA-256 checksum
How to use checksums
8dd1fd5253122ee39d5653637f6b431704f84b5f55f6ebd5926d9f9eddabf5ed
BLAKE2b-256 checksum
How to use checksums
beae5647d30fdbd1e2c99dfe75e4ea759baf507bfdbd90c7e7fd2c5449a5c51e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.

Transparency log

Release files / guard_core_mcp-1.4.4-py3-none-any.whl

Download URL guard_core_mcp-1.4.4-py3-none-any.whl
Size 697.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
336c65ca04ef83b2125ad87e584589c185f052c296c6c0422acd9e162f7adcb1
BLAKE2b-256 checksum
How to use checksums
3e8bc75f888e68a7a3183fa2df105e14641f9eaec39e8470f10a3e0d147b1f82
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.

Transparency log

Release history Release notifications | RSS feed

1.6.0

2 release files

1.5.0

2 release files

1.4.5

2 release files

This release

1.4.4 This release

2 release files

1.4.3

2 release files

1.4.2

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.0

2 release files

1.1.1

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page