Back to blog

Engineering · Draft date pending

MCP Spotlight: HoneyLabs — Ground-Truth Threat Intelligence From a Honeypot Fleet, Direct to Your Agent

HoneyLabs gives agents ground-truth threat intelligence from its own honeypot fleet — not repackaged third-party data. 7 tools for IOC lookup, fingerprint search, attack timelines, and ASN enrichment. Free tier: 500 credits/day.

MCP ServerHoneyLabsThreat IntelligenceCybersecurityHoneypotAI Agents

MCP Spotlight: HoneyLabs — Ground-Truth Threat Intelligence From a Honeypot Fleet, Direct to Your Agent

Server: honeylabs-mcp by HoneyLabs Stars: 7 · License: MIT (honeypot fleet: open source; MCP surface: closed) MCP Transport: Streamable HTTP + OAuth 2.1 (PKCE + DCR) Endpoint: https://mcp.honeylabs.net/mcp · Free tier: 500 credits/day · Last updated: May 27, 2026

What It Does

Most threat intelligence MCP servers are thin wrappers around someone else's data. They proxy VirusTotal lookups, query AbuseIPDB, or wrap a reputation feed that was already stale when it left the CSV export.

HoneyLabs is fundamentally different. It runs its own honeypot fleet — the Spip-Go network sensors sit on the public internet and log every probe that reaches them. Every TCP connection, every TLS handshake, every HTTP request, every SSH negotiation. 90 days of ground-truth observations — not repackaged third-party data — exposed as MCP tools your agent can query directly.

What your agent gets: not "this IP was reported malicious by someone," but "this IP probed our honeypots on port 445 at 14:32 UTC yesterday with this specific JA4 fingerprint and this payload."

Why It Matters for Agent Engineering

There are two kinds of threat intelligence data: reputation (someone else decided this is bad) and observation (we watched this happen). Reputation data has latency — an IP scans for days before it lands on a blocklist. Observation data is real-time — the moment a scanner touches a honeypot, it's logged and queryable.

For AI agents building security automation, this distinction is critical. An agent doing automated threat triage needs to answer:

  • "Is this IP actively scanning right now?"
  • "What specific CVEs is it probing for?"
  • "Does its TLS fingerprint match known scanner infrastructure?"
  • "What other IPs in the same ASN are showing the same behavior?"

HoneyLabs answers all four from its own sensor data. No reputation lag. No third-party API dependencies. Just the raw telemetry of what's actually happening on the internet right now.

The MCP Tool Surface

Seven tools, each designed for a specific investigative question:

ToolWhat It Answers
ioc_lookupIs this IP/domain known to be probing? When was it last seen? What ports and paths does it hit?
top_attackersRanked leaderboard of source IPs, ASNs, countries, ports, or user-agents over a time window.
search_eventsRaw honeypot events matching filters — IP, ASN, country, dest_port, protocol, http_method.
attack_timelineHourly/daily attack volume over a window, with protocol, country, and port filters.
asn_enrichFull profile for an ASN: total events, unique IPs, top ports, source countries, user-agents, org name.
fingerprint_searchSearch by TLS JA4 / HTTP JA4H / SSH HASSH fingerprint — find shared infrastructure across IPs.
payload_searchFull-text URL-path + user-agent search across attack traffic. Pro tier.

Each tool response row counts as one credit. Free tier: 500 credits/day — enough for serious automation. Pro: 50,000. Team: 500,000.

Architecture: Not Just a Wrapper — a Fleet

HoneyLabs' architecture has three layers, two of which are open source:

Layer 1: Spip-Go (Open Source)

A lightweight, low-interaction network honeypot sensor written in Go. Listens for arbitrary TCP traffic (plain and TLS), captures everything scanners send, and logs each connection as structured ECS-shaped JSON. Built-in fingerprinting adds:

  • Community ID v1 — flow hash matching Zeek/Suricata output
  • JA4 — TLS client fingerprint from ClientHello
  • JA4H — HTTP client fingerprint from first request
  • HASSH — SSH client fingerprint from KEXINIT negotiation

Each sensor can optionally ship logs to Loom for enrichment and indexing.

Layer 2: Loom (Open Source)

The enrichment and indexing pipeline. Takes raw Spip logs, enriches with ASN/geo data, indexes fingerprints, and matches payloads against CVE exploit signatures. Powers the query engine behind the MCP tools.

Layer 3: MCP Server (Closed)

The streamable HTTP endpoint at mcp.honeylabs.net/mcp. Exposes the seven tools, handles OAuth 2.1 with PKCE + DCR for agent authentication, and enforces credit quotas per tier.

This isn't a thin API proxy — it's a full observation-to-query pipeline where the honeypot fleet generates the data.

Fingerprint-Driven Investigation

The fingerprint_search tool enables a uniquely powerful workflow: finding shared infrastructure behind seemingly unrelated IPs.

An attacker rents VPSes from five different providers. Each has a different IP, different ASN, different country. But they all run the same scanner binary, which means they share the same TLS JA4 fingerprint:

t13d1516h2_8daaf6152771_b1ff8ab2d16f

Your agent calls fingerprint_search(ja4="t13d1516h2_8daaf6152771_b1ff8ab2d16f") and gets every IP in the HoneyLabs dataset that presented that exact TLS fingerprint. Suddenly five seemingly unrelated IPs are connected by shared infrastructure — and your agent found it in one query.

This works across all three fingerprint types: JA4 (TLS), JA4H (HTTP), and HASSH (SSH). An SSH brute-forcer switching IPs every hour still has the same HASSH fingerprint. An HTTP scanner rotating through rented proxies still has the same JA4H.

Connecting HoneyLabs to Your Agent

Step 1: Get an API Key

Visit honeylabs.net/dashboard — magic-link sign-in, no password required. Copy your API key.

Step 2: Add to MCP Config

{
  "mcpServers": {
    "honeylabs": {
      "url": "https://mcp.honeylabs.net/mcp",
      "headers": {
        "Authorization": "Bearer ${credentials.HONEYLABS_API_KEY}"
      }
    }
  }
}

Step 3: Or Use OAuth (Gemini, MCP Inspector, Smithery, Cline)

gemini /mcp add honeylabs https://mcp.honeylabs.net/mcp
gemini /mcp auth honeylabs    # OAuth flow, no static key

OAuth 2.1 with PKCE + DCR is supported at /oauth/authorize. Any MCP client that speaks standard OAuth works out of the box.

Production Patterns

Automated Scanner Triage

With HoneyLabs connected to Facio, a security agent can run autonomous triage on inbound connection logs:

Agent workflow (triggered by firewall log):
1. Extract source IPs from blocked connection events
2. For each IP: honeylabs.ioc_lookup → ports, paths, last seen, CVE matches
3. For high-activity IPs: honeylabs.asn_enrich → ASN profile, related IPs
4. For suspicious IPs: honeylabs.fingerprint_search → shared infrastructure
5. Route confirmed scanners to blocklist; flag unknowns for human review

The agent handles the repetitive lookups. Human analysts review only the borderline cases. Every decision is grounded in observation data, not third-party reputation scores.

CVE Trend Monitoring

Track which CVEs are being actively probed — not from CVSS scores or vendor advisories, but from actual attack traffic:

Agent workflow (daily cron):
1. honeylabs.top_attackers → current top scanning IPs
2. For top 10: honeylabs.ioc_lookup → CVE matches
3. Group by CVE, count unique IPs probing each
4. Compare to yesterday: which CVEs are surging?
5. Alert on surges — patch prioritization driven by real attack data

This turns CVE management from "patch everything with CVSS ≥ 7.0" to "patch what's actually being exploited against your infrastructure profile."

IOC Feed Automation

HoneyLabs supports watchlists — save any query as a named watchlist, get an IOC feed URL that firewalls and SIEMs can pull:

# Firewall-ready IP list, refreshed every 5 minutes:
curl -fsS 'https://honeylabs.net/feed/<token>' > /etc/blocklist.txt

# Structured CSV for SIEM ingestion:
curl 'https://honeylabs.net/feed/<token>.csv'

# Full event records for custom analysis:
curl 'https://honeylabs.net/feed/<token>.json'

Your Facio agent can create watchlists programmatically, rotate feed tokens, and manage the full lifecycle of IOC distribution — from honeypot observation to firewall rule.

Comparison: HoneyLabs vs. Traditional Threat Intel

CapabilityHoneyLabs MCPTraditional TI Feeds
Data sourceOwn honeypot fleetThird-party aggregation
Observation latencyReal-time (probe → indexed)Hours to days (report → publish)
Fingerprint search✓ JA4 + JA4H + HASSH— Rarely available
CVE probe tracking✓ Exploit pattern matching on payloads— CVSS scores only
ASN enrichment✓ Full profile: events, IPs, ports, UAs— Partial or stale
IOC feed generation✓ Watchlists → revocable feed URLs— Manual export
OAuth 2.1 agent auth✓ PKCE + DCR— API keys only
Free tier✓ 500 credits/day— Varies, often trial-only
Raw event accesssearch_events with full filters— Aggregated only

For security teams building agent-driven workflows, the owned-sensor model means no dependency on third-party data quality or timeliness. Your agent queries what happened on your sensors.

Key Takeaways

  • Ground-truth observations: Not repackaged reputation data — actual probes logged by HoneyLabs' own honeypot fleet
  • Seven MCP tools: IOC lookup, attacker leaderboards, event search, attack timelines, ASN enrichment, fingerprint search, payload search
  • 90 days of data: Every TCP connection, TLS handshake, HTTP request, and SSH negotiation indexed and queryable
  • Fingerprint investigation: JA4 (TLS), JA4H (HTTP), HASSH (SSH) — find shared infrastructure across seemingly unrelated IPs
  • CVE trend tracking: Payload-to-exploit-pattern matching — see which CVEs are being actively probed, not just CVSS-scored
  • Watchlists → IOC feeds: Save any query as a revocable feed URL for firewalls, Pi-holes, and SIEM ingestion
  • OAuth 2.1 with PKCE: Agent-native authentication — no static key management required
  • Two open-source layers: Spip-Go (honeypot sensor) and Loom (enrichment pipeline) are public — inspect how the data is generated

HoneyLabs: honeylabs.net · MCP endpoint: https://mcp.honeylabs.net/mcp · Dashboard: honeylabs.net/dashboard · Spip-Go: github.com/honeylabshq/Spip-Go · Loom: github.com/honeylabshq/Loom · Glama: glama.ai/mcp/servers/honeylabshq/honeylabs-mcp · Facio MCP docs: facio.bot/docs/mcp

Keep reading

More on Engineering

View category
Jul 21, 2026Engineering

MCP Server Authoring Guide 2026: Building Production-Grade MCP Servers From Scratch — The Authoring Playbook Every Independent Server Author Should Follow

The 12 decisions every MCP server author must make: transport, SDK, license, auth, secrets, tool surface, output format, error handling, rate limiting, idempotency, distribution, documentation. Plus standard patterns (pagination, search, bulk, async, webhooks), security hardening, testing strategy, versioning, and the publishing checklist.

Jul 20, 2026Engineering

MCP Spotlight: GitHub MCP Server — The Official Code-and-Collaboration Bridge With Fine-Grained PATs, PR/Issue Workflows, and the Engineering-Workflow Default for Agents

The official GitHub MCP Server by GitHub — ~40 focused tools covering issues, PRs, code, commits, branches, Actions, releases, reviews, security alerts. Fine-Grained Personal Access Token support for per-repo + per-action scope isolation. Branch-protection-aware merge control. MIT-licensed. The code-collaboration default for AI agents in 2026.

Jul 19, 2026Engineering

MCP Spotlight: Docker MCP Server — The Container Operations Bridge With `mcp://` Catalog Protocol, MCP Toolkit, and the Container-Default Reference for Agents

Docker's official MCP infrastructure — the Docker Hub MCP Catalog (300+ verified servers with signatures + provenance), the MCP Toolkit (isolated runtime execution via Docker MCP Gateway), and the mcp:// URL protocol for declarative installation. Apply container-ecosystem primitives (signing, isolation, secrets, orchestration) to MCP.