Skip to main content

Security scanner and graph for agentic infrastructure — agents, MCP, runtime, and blast radius.

Project description

agent-bom

Open security scanner for AI supply chain — agents, MCP servers, packages, containers, cloud, GPU, and runtime.

Start with the demo, then choose the entrypoint that matches your first job: repo scan, image scan, cloud posture, fix plan, dashboard, or runtime review.

CVE-2025-1234  (CRITICAL · CVSS 9.8 · CISA KEV)
  |── better-sqlite3@9.0.0  (npm)
       |── sqlite-mcp  (MCP Server · unverified · root)
            |── Cursor IDE  (Agent · 4 servers · 12 tools)
            |── ANTHROPIC_KEY, DB_URL, AWS_SECRET  (Credentials exposed)
            |── query_db, read_file, write_file, run_shell  (Tools at risk)

 Fix: upgrade better-sqlite3 → 11.7.0

Blast radius is the core idea: CVE -> package -> MCP server -> agent -> credentials -> tools.

Scan local agent configs, MCP servers, instruction files, lockfiles, containers, cloud posture, GPU surfaces, and runtime evidence.

Try the built-in demo first:

agent-bom agents --demo --offline

The demo uses a curated sample so the output stays reproducible across releases. For real scans, run agent-bom agents, or add -p . to fold project manifests and lockfiles into the same result.

See the terminal demo

agent-bom demo

Recommended starting points

pip install agent-bom

agent-bom agents -p .                            # Repo + MCP + package blast radius
agent-bom check flask@2.2.0 --ecosystem pypi     # Pre-install package verdict
agent-bom image nginx:latest                     # Container image scan
agent-bom agents -p . --remediate remediation.md # Fix-first remediation plan
pip install 'agent-bom[ui]'                      # once, if you want the dashboard
agent-bom serve                                  # API + dashboard + graph explorer

Product views

Dashboard

agent-bom dashboard overview

Focused graph

agent-bom focused graph

What it scans

  • Agents + MCP — MCP clients, servers, tools, transports, trust posture
  • Skills + instructionsCLAUDE.md, AGENTS.md, .cursorrules, .windsurfrules, skills/*
  • Package risk — software supply chain scanning with enrichment and blast radius
  • Container images + IaC — native OCI parsing plus Dockerfile, Terraform, CloudFormation, Helm, and Kubernetes coverage
  • Cloud AI — cloud and AI infrastructure posture across major supported providers
  • Secrets + runtime — MCP proxy, Shield SDK, secrets, and redaction surfaces
  • Compliance + evidence — mapped governance plus ZIP evidence bundles for auditors

Key features

  • Blast radius mapping — CVE → package → MCP server → agent → credentials → tools
  • CWE-aware impact — RCE shows credential exposure, DoS does not
  • Portable outputs — SARIF, CycloneDX, SPDX, HTML, graph, JSON, ZIP evidence bundles, and more
  • MCP server mode — expose agent-bom capabilities directly to MCP clients like Claude, Cursor, Windsurf, and Cortex CoCo / Cortex Code
  • Skill bundle identity — stable bundle hashes for skill and instruction file review
  • Dependency confusion detection — flags internal naming patterns
  • VEX generation — auto-triage with CWE-aware reachability

Read-only. Agentless. No secrets leave your machine unless you explicitly enable an outbound integration.

How the data moves

How agent-bom works

Blast radius

Blast radius

Links

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

agent_bom-0.80.1.tar.gz (3.8 MB view details)

Uploaded Source

Built Distribution

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

agent_bom-0.80.1-py3-none-any.whl (3.4 MB view details)

Uploaded Python 3

File details

Details for the file agent_bom-0.80.1.tar.gz.

File metadata

  • Download URL: agent_bom-0.80.1.tar.gz
  • Upload date:
  • Size: 3.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for agent_bom-0.80.1.tar.gz
Algorithm Hash digest
SHA256 3e6e264053c85a9657ecbee7dfc4a36f5bf8f751aee626c35a05704d8f77187e
MD5 60bb40bbb76ab7a32ff3f91371262f7a
BLAKE2b-256 bea4f6c2135cb46ebfa4f6f7604458375afaf1f445e9e39ea48ab65da150e28e

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_bom-0.80.1.tar.gz:

Publisher: release.yml on msaad00/agent-bom

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

File details

Details for the file agent_bom-0.80.1-py3-none-any.whl.

File metadata

  • Download URL: agent_bom-0.80.1-py3-none-any.whl
  • Upload date:
  • Size: 3.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for agent_bom-0.80.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ea2af7e8db074ec935c075df232662ea69a6c86ccbdbbea8e9fc6c0943e2a5d1
MD5 aaecbe0d65f56104fecdc29dda184ce9
BLAKE2b-256 5e0fb28624fa3c4e2d95e3eb3877ee89b4c6abb4d35d0a4effbf527b29993deb

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_bom-0.80.1-py3-none-any.whl:

Publisher: release.yml on msaad00/agent-bom

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

Supported by

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