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