list_top_malware

Returns the most-referenced malware families across intelligence reporting, ranked by mention count. Costs 1 credit.

Cost: 1 credit per successful call  ·  Response shape: jsonb

Parameters

Example invocation

Ask your agent: "What are the top 15 malware families showing up most frequently in threat reporting?"

curl -s https://api.edgeprotect.io/functions/v1/mcp \
  -H "Authorization: Bearer $EDGEPROTECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_top_malware","arguments":{"limit":15}}}'

Response

{
  "count": 15,
  "items": [
    { "family": "Cobalt Strike", "mention_count": 412, "first_blogged": "2014-03-01" },
    { "family": "QakBot",        "mention_count": 287, "first_blogged": "2008-09-15" },
    { "family": "Emotet",        "mention_count": 261, "first_blogged": "2014-06-10" }
  ],
  "generated_at": "2026-05-18T10:24:31.118Z"
}

The full MCP envelope is described in Response Format.

Errors