{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_w27wfnv2p59c","handle":"bbot-mcp","url":"https://wellknown.network/agents/bbot-mcp","links":{"self":"https://wellknown.network/agents/bbot-mcp/record.json","html":"https://wellknown.network/agents/bbot-mcp","markdown":"https://wellknown.network/agents/bbot-mcp/record.md","api":"https://wellknown.network/api/v1/agents/bbot-mcp","status":"https://wellknown.network/api/v1/agents/bbot-mcp/status","claim":"https://wellknown.network/agents/bbot-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bbot-mcp/claim.json","badge":"https://wellknown.network/agents/bbot-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:bbot-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bbot-mcp","summary":"MCP server for BBOT security scanner","description":"# BBOT MCP Server\n\nA Model Context Protocol (MCP) server for running [BBOT](https://github.com/blacklanternsecurity/bbot) security scans. This server provides tools to manage and execute bbot scans through the MCP interface.\n\n## Features\n\n- **Module Management**: List and explore available bbot modules\n- **Preset Management**: List and use predefined scan configurations\n- **Scan Execution**: Start and manage long-running bbot scans\n- **Real-time Monitoring**: Check scan status and retrieve results\n- **Wait & Progress Tracking**: Wait for scan completion with timeout and progress reporting\n- **Concurrent Scans**: Support for multiple simultaneous scans\n- **Dependency Management**: Comprehensive sudo prevention and no-deps functionality\n\n## Installation\n\n### From PyPI (Recommended)\n```bash\npip install bbot-mcp\n```\n\n### From Source\n```bash\ngit clone https://github.com/marlinkcyber/bbot-mcp.git\ncd bbot-mcp\npip install -e .\n```\n\n### Using uvx (Run without installing)\n```bash\nuvx bbot-mcp\n```\n\n## Install dependencies\n\nIt is recommended to install all BBOT dependencies before invoking BBOT MCP server:\n\n```bash\nbbot --install-all-deps\n```\n\n## Usage\n\n### Running the MCP Server\n\nAfter installation, the server can be started using the `bbot-mcp` command:\n\n```bash\nbbot-mcp\n```\n\nOr directly with Python:\n```bash\npython -m bbot_mcp.server\n```\n\n### Available Tools\n\nThe MCP server provides **8 tools** for comprehensive bbot scan management:\n\n#### 1. `list_bbot_modules()`\nLists all available bbot modules categorized by type (scan, output, internal).\n\n#### 2. `list_bbot_presets()`  \nLists all available bbot presets for quick scan configuration.\n\n#### 3. `start_bbot_scan(targets, modules=\"\", presets=\"\", flags=\"\", no_deps=True)`\nStarts a new bbot scan with the specified parameters.\n\n**Parameters:**\n- `targets`: Comma-separated list of targets (domains, IPs, URLs)\n- `modules`: Optional comma-separated list of modules to use\n- `presets`: Optional comma-separated list of presets to apply\n…","publisher":null,"homepage":"https://github.com/marlinkcyber/bbot-mcp","repository":"https://github.com/marlinkcyber/bbot-mcp","version":"0.1.4","license":"MIT","protocols":["mcp"],"tags":["bbot","mcp","scanner","security"],"pricing":null,"endpoints":[{"url":"pypi:bbot-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"security.scanning","name":"Security Scanning","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.825,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"bbot-mcp","registry":"pypi","observedAt":"2026-09-09T10:29:42.290Z","publishedAt":"2025-08-13T04:23:54.721965Z","latestVersion":"0.1.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bbot-mcp","url":"https://pypi.org/project/bbot-mcp/","firstSeenAt":"2026-09-09T10:26:44.029Z","fetchedAt":"2026-09-09T10:26:44.029Z","normalizedAt":"2026-09-09T10:26:44.029Z"}]},"firstSeenAt":"2026-09-09T10:26:44.029Z","updatedAt":"2026-09-09T10:29:42.290Z"}