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. Mylonite also maintains an independent verification harness that scores it against external ground truth it did not author — runnable vulnerable MCP servers and published academic benchmarks.

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: it exits non-zero on the substantive W1–W4 structural findings, and treats the "unpinned descriptions" advisory (which fires on every tool of every server on first contact) as a suggestion, not a gate — so it is adoptable from day one.

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-file <path> — scores each safeguard as load-bearing vs. security theater. Requires a target file; the bundled reference targets are not accepted.
  • 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.3.tar.gz (559.4 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.3-py3-none-any.whl (541.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mylonite-0.8.3.tar.gz
  • Upload date:
  • Size: 559.4 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.3.tar.gz
Algorithm Hash digest
SHA256 8f0f50c10a1cfca402cddad2862e29a7affbeb51c66d6be16e5a3a0f18f8156b
MD5 a003de94239753f948592ffda9d4c821
BLAKE2b-256 e709ceb2eebad39892f9cb4a839cff546e3d3807b484b5d101eec611e1014efb

See more details on using hashes here.

Provenance

The following attestation bundles were made for mylonite-0.8.3.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.3-py3-none-any.whl.

File metadata

  • Download URL: mylonite-0.8.3-py3-none-any.whl
  • Upload date:
  • Size: 541.6 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3bd96f544c61b7068aa9991474669fb8a690d53d73af2de15b4cb46fe2e6bfe2
MD5 d66912f247ed6d3463d7dd2a623e3f42
BLAKE2b-256 32dc2e341787082a991b4de146a4b063e29ca38555f93dc11275910b80bf71cb

See more details on using hashes here.

Provenance

The following attestation bundles were made for mylonite-0.8.3-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

0.9.0

2 files

0.8.6

2 files

0.8.5

2 files

0.8.4

2 files

This release

0.8.3 This release

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

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

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