Skip to main content

Mylonite

Model robustness is not the same as application security. A frontier model can resist every generic prompt-injection you throw at it and still hand an attacker a win, because the hole is in your app's design, not the model's alignment. Mylonite tests whether your app-layer controls are what stop the attack, writes a validated regression test for each weakness it finds, and gates CI so a model upgrade can't silently strip the protection away.

CI PyPI GitHub release License

Built for teams shipping MCP or agentic apps who need CI-enforced regression coverage on the AI layer.

Point Mylonite at any MCP (Model Context Protocol) app, whatever model or framework is behind it. It attacks the AI/agentic layer — the system prompt and tool/function schemas — finds app-specific weaknesses, and for each one emits a validated, CI-gating pytest regression test.

The core differentiator is the control-efficacy check. It holds the model constant and toggles only the safeguard, keeping a finding only when the attack fires on your app and is resisted once the control is applied, across a repeat-run filter that absorbs LLM randomness. That proves the control carries the security, not the model's current good behavior, and it works on a single real app with no second build required. Every headline claim is backed by an independent verification harness that scores Mylonite against external ground truth it did not author.

Mylonite deliberately does not test the surrounding traditional code; that work belongs to SAST/DAST tools.

Where this sits. Static scanners read your tool descriptions and flag the ones that look dangerous; you are left to judge which flags matter. Model-eval harnesses swap models and score which one behaves best. Mylonite does neither. It runs the attack against your app, then holds the model constant and toggles only your safeguard — so the finding you get back is evidence about your control, not about how a description reads or how a model scored today.

Example: same model, two versions of one app. Run the same model against the two versions of the bundled reference app. Against the deliberately-vulnerable version Mylonite catches a send_email dispatched with no approval step — a pure app-design flaw no amount of model alignment fixes. Against the guarded version it finds nothing. Same model; the app's design decides the outcome. That is the difference between "your chatbot behaved today" and "your app is secure." See the full independent scorecard, negatives included.

See ROADMAP.md for the architecture, scope, and direction, and the documentation site for guides and reference.

Status: the full scan → generate → validate → gate pipeline works end to end, against your own MCP app over stdio or remote SSE/HTTP (--target-file) and the bundled reference app. The control-efficacy check proves which safeguard is load-bearing on any single-build app; mylonite ablate scores the whole control set (load-bearing vs. security theater). A third-party verification harness checks every claim against external ground truth. pip install mylonite installs the CLI from PyPI. See CHANGELOG.md.

Try it

The first step is free — point scan at your own MCP app with --scaffold. It needs no API key and makes no model call: it connects to your server, lists the tools it exposes, tells you which weakness classes apply to that surface, flags the consequential-action tools worth guarding, and writes a starter app.yaml:

mylonite scan --command "python" --arg "my_server.py" --scaffold app.yaml --scope my-app   # free, no API key

Treat it as a scope check, not a verdict: it reads your tool surface, not your tool descriptions, and everything it suggests is a hint for you to confirm.

Still free: mylonite check --target-file app.yaml connects once (still no API key, still no attack) and reports structural exposure — consequential tools with no approval step, descriptions that steer the agent, tools taking a network destination, and unpinned descriptions. --enforce turns it into a CI gate once the surface is clean.

Proving which weaknesses actually land — and which of your controls stops them — is the scan itself, and that needs a key:

mylonite scan --target-file app.yaml --authorize my-app                    # needs an LLM API key

Don't have your own app handy yet? pip install mcp-kitchen-sink alongside mylonite and run the same loop against the bundled, deliberately-vulnerable reference app instead — see the reference app:

mylonite scan reference:vulnerable   # finds seeded weaknesses
mylonite scan reference:guarded      # same attacks, comes up clean

From scan to a gating PR

mylonite gate runs the whole pipeline — find an exploit, write a regression test, validate it against the control-efficacy check, and (opt-in) open a PR that gates CI on it:

mylonite gate reference:vulnerable          # find -> test -> validate -> print the PR command
mylonite gate --target-file app.yaml --authorize my-app --open-pr   # ...and open it

gate writes a validated regression test under .mylonite/gate/ plus two CI workflows (a cheap per-PR gate + nightly discovery), then prints (or, with --open-pr, opens) a PR carrying the finding, its OWASP/ASI/ATLAS/NIST tags, the validation evidence, and an evidence-anchored recommended fix naming the actual tool and argument that landed the exploit. Full guide: docs/ci-gating.md. Behind a corporate network, see docs/enterprise-networking.md.

What works today

Every command has a backing verification number or a committed differential proof. The core surface:

  • mylonite check --target-file <path> — static structural pre-check: no LLM, no API key, no spend. --enforce turns it into a CI gate; belongs in stage 1, next to lint.
  • mylonite gate <target> — the end-to-end flow: scan → generate → validate → optionally open a gating PR. Writes the regression test and two CI workflow templates.
  • mylonite scan <target> — the exploit-finding loop against the bundled reference app or your own MCP app (--target-file). --scaffold introspects a server and writes a starter target.yaml.
  • mylonite generate <dir> — emits the pytest regression test from a confirmed exploit (run for you as a stage of gate).
  • mylonite validate <dir> — proves an emitted test is meaningful via the control-efficacy check (the core differentiator); --fast skips it for a weaker gate.
  • mylonite ablate <target> — scores each safeguard as load-bearing vs. security theater.
  • mylonite report <dir> — a terminal trust panel (including the recommended-fix panel), SARIF 2.1.0, or a JSON bundle, all carrying the differential proof, the compliance tags, and the same evidence-anchored recommendation.
  • mylonite version — print the installed version.

Full command details in the CLI reference. Remote MCP transport (SSE / streamable-HTTP), versioned extension contracts, and entry-point plugins are covered in the architecture guide.

Documentation

Full docs site: abidemialade.github.io/mylonite (or mkdocs serve from a checkout). Highlights:

Responsible use

Mylonite reproduces working weaknesses in AI agents. Use it only against targets you control or are contractually authorized to test. Every command that live-drives a real target — scan, gate, validate, and ablate — refuses to run without an explicit --authorize flag naming that target: the value must equal the target's declared scope, or its family name when no scope is declared. The bundled vulnerable reference agent runs in-process and binds to nothing.

Full policy: SECURITY.md.

License

Apache License 2.0. See LICENSE and NOTICE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mylonite-0.8.0.tar.gz (502.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mylonite-0.8.0-py3-none-any.whl (490.4 kB view details)

Uploaded Python 3

File details

Details for the file mylonite-0.8.0.tar.gz.

File metadata

  • Download URL: mylonite-0.8.0.tar.gz
  • Upload date:
  • Size: 502.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mylonite-0.8.0.tar.gz
Algorithm Hash digest
SHA256 eed6b368597aaeb20e2d720bea6b83ba35b3e08194921f2e84e5057a05ce6e47
MD5 a395a00e4ea201a061e9b081fb2b7820
BLAKE2b-256 b05637af2eec57551489f5d0cbce25b524cc8ce7596d081066f8a7f61ca1b185

See more details on using hashes here.

Provenance

The following attestation bundles were made for mylonite-0.8.0.tar.gz:

Publisher: release.yml on Abidemialade/mylonite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mylonite-0.8.0-py3-none-any.whl.

File metadata

  • Download URL: mylonite-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 490.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mylonite-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e02521e29279aa4e6e83c85091c5b007e60213b175d71179009c5b6b2b9d644e
MD5 b8dabfc31cdc2d1628457f6e4fe1bd10
BLAKE2b-256 f73ae784320f05552621a908192217aa503c8fe5e226ee73264d38233c8cf836

See more details on using hashes here.

Provenance

The following attestation bundles were made for mylonite-0.8.0-py3-none-any.whl:

Publisher: release.yml on Abidemialade/mylonite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.8.0 This release

2 files

0.7.8

2 files

0.7.7

2 files

0.7.6

2 files

0.7.5

2 files

0.7.4

2 files

0.7.3

2 files

0.7.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page