v1.1.0 one autonomous scan · same-run proof

The red team framework for AI agent infrastructure.

Drop one static collector on a compromised host. One active scan captures configs and raw credentials, discovers MCP, A2A and AI services, reuses compatible secrets, proves concrete access, and checkpoints the evidence before the foothold disappears. Ingest later for full graph analysis.

$ curl -sSfL https://raw.githubusercontent.com/adithyan-ak/agenthound/1.1.0/install.sh | AGENTHOUND_VERSION=1.1.0 sh
Active by default --stealth read-only mode One JSON artifact Optional analysis server
Full-spectrum coverage

Collects and connects evidence across MCP servers, A2A agents, LiteLLM, Ollama, vLLM, Qdrant, MLflow, Jupyter, Open WebUI, and LangServe.

The agentic stack

One framework, spanning every layer.

AgentHound treats the compromised host, agent clients, protocols and reachable AI services as one expanding target set. Local secrets and network observations feed the same planner and the same artifact.

The agentic stack: AgentHound spans all of it targetsevidence
AgentHound
Agent clientplane
12 agent-client config formatsinstruction filesraw credentials
Protocolplane
MCP (stdio + network)A2A agent cards · skills · JWStools · resources · prompts
Model gatewayplane
LiteLLM posture · models · aliasesmaster keys · virtual-key context
Inferenceplane
Ollama model · modelfile · prompt inventoryvLLMdeep compute proof
Vector / RAGplane
Qdrant collections · schemadeep payload samples
MLOpsplane
MLflow experiments · runs · registryartifact and storage URIs
Notebookplane
Jupyter sessions · notebooks · filesanonymous + token access
Frontendplane
Open WebUI auth · RAG · upstream keysLangServecredential expansion
One command owns the operation

Drop it once. Let the scan keep moving.

The local planner turns every new endpoint, credential and capability into the next useful candidate. The operator chooses scope and mode—not a sequence of internal modules.

01

Map the foothold

Capture supported configs, instruction sources, concrete credentials, local interfaces and configured endpoints.

02

Discover & collect

Find MCP, A2A and AI services; fingerprint them and inventory useful data anonymously or with exact configured auth.

03

Expand & prove

Reuse compatible secrets, prove exact MCP resource access, and run eligible bounded active validations in the same scan.

04

Preserve & analyze

Checkpoint every result and recovery transition locally. Ingest the artifact later for complete graph analysis and triage.

Evidence becomes paths

Prove access now. Pathfind when ready.

The collector can verify exact credential-to-resource access without a database on the foothold. Manual ingestion later adds full-graph reachability, execution, exfiltration, impersonation, poisoning and data-flow analysis.

Observed evidence becomes analysis

observed · inferred · verified
AgentInstance TRUSTS_SERVER MCPServer
MCPServer PROVIDES_TOOL MCPTool
MCPTool HAS_ACCESS_TO MCPResource
Credential CREDENTIAL_ACCESS_OBSERVED MCPResource
AgentInstance CAN_REACH · VERIFIED MCPResource
AgentInstance CAN_EXECUTE MCPTool
AgentInstance CAN_EXFILTRATE_VIA MCPTool
Exact credential + exact resource proof upgrades the matching path to Verified During Scan.
AgentHound attack-surface dashboard showing agents, MCP servers, A2A agents, tools, credentials, exposure and finding severity
The optional dashboard is the secondary inspection surface for findings, attack paths, credentials, risk, history and triage.
Offensive where it matters

Useful evidence, autonomous action, minimal operator friction.

AgentHound 1.1 prioritizes what a red-team operator can collect and prove during a short-lived foothold. Every capability feeds the same planner, artifact and graph.

Same scan

Raw credential capture becomes immediate reach

Concrete bearer tokens, API keys, master keys and Jupyter tokens are stored as usable material, deduplicated by value hash and associated with every source. The planner re-indexes new credentials as they appear and presents them only through compatible service adapters.

Verified

Differential MCP access proof

Compare an anonymous control read with an authenticated read of the exact resource. Denied without the credential and allowed with it becomes Verified During Scan evidence—not a reachability guess.

Reversible

ContextForge description round trip

For an eligible managed tool, write a scan-specific marker, observe it through MCP, immediately restore the original and independently confirm restoration before planning continues.

Deep

Deep model and service intelligence

Inventory Ollama models, modelfiles, templates and system prompts; LiteLLM gateway context; MLflow registries; Jupyter files; and Qdrant collections. Deep mode adds recursive instructions, vector payload samples and bounded Ollama embedding invocation.

OPSEC

Stealth mode and hard exclusions

--stealth disables credential reuse, compute, tool invocation and mutation. Repeatable exclusions guard hostnames, addresses, CIDRs, DNS results, redirects, derived URLs, cleanup calls and final dials.

Durable

Built for loss of access

The collector creates an ingest-valid artifact before network work and checkpoints each meaningful result and action transition. Recovery state is persisted before mutation; unresolved cleanup can be retried with agenthound revert.

Analysis

Full-graph attack paths and findings

Manual ingestion turns the artifact into published findings and paths across reachability, credential chains, execution, exfiltration, impersonation, shadowing, poisoned context and untrusted data flow. Risk scoring, scan history, diffing and triage remain on the optional analysis system.

One command, four clear modes

Choose the operational posture—not the modules.

Active verification is the default. Add depth when the foothold and time budget allow it, or switch to stealth when the operation must remain read-only.

01
agenthound scan
Active collection, compatible credential reuse, MCP access proof and eligible reversible ContextForge validation.
02
agenthound scan --deep
Adds recursive instructions, Qdrant payload samples, expensive probes and bounded Ollama embedding invocation.
03
agenthound scan --stealth
Anonymous and exact configured read-only collection. No cross-target reuse, compute, tool invocation or mutation.
04
agenthound scan --stealth --deep
Adds deep filesystem and payload reads while retaining every stealth restriction.
Collector first. Analysis later.

Start from the foothold in one command.

The collector is a static binary with no database or server dependency. It writes one local JSON artifact; move that artifact to the optional analysis system when the operation allows.

1

Install AgentHound 1.1.0

single collector binary → ~/.local/bin
$curl -sSfL https://raw.githubusercontent.com/adithyan-ak/agenthound/1.1.0/install.sh | AGENTHOUND_VERSION=1.1.0 sh
$brew install adithyan-ak/agenthound/agenthound
2

Run one autonomous scan

local configs and credentials are always included; a target adds network scope
$agenthound scan --output scan.json
$agenthound scan 10.20.0.0/24 --deep --exclude 10.20.0.15 --output scan.json
3

Start the optional analysis stack

run this on the analysis system; binds 127.0.0.1:8080
$curl -sSfL https://raw.githubusercontent.com/adithyan-ak/agenthound/1.1.0/docker/docker-compose.public.yml -o agenthound-compose.yml
$docker compose -f agenthound-compose.yml -p agenthound up -d --wait
4

Manually ingest the artifact

then open http://127.0.0.1:8080
$docker compose -f agenthound-compose.yml -p agenthound exec -T agenthound agenthound-server ingest - < scan.json

One foothold. One scan. Use the access while it exists.

Active verification is the default. Use --stealth for read-only collection. The artifact stores concrete credentials and returned content in plaintext, so handle it like operational evidence.