# JSON Logs

> Use this tool when you need to analyze and query structured log data from Python applications, solving problems like debugging, monitoring system behavior, and performance pattern analysis. It takes JSON log files as input and provides filtered, aggregated, and statistical outputs, allowing AI assistants to search and understand log data by level, module, function, and time ranges. Ideal for use cases where insights from structured log data can inform application optimization and troubleshooting decisions.

Canonical page: https://skillsregistry.net/skills/mfreeman451-json-logs  
JSON: https://api.skillsregistry.net/v1/skills/mfreeman451-json-logs

## Description

This MCP server provides JSON log file analysis capabilities, enabling AI assistants to query, filter, and aggregate structured Python application logs stored locally. Built by Michael Freeman using Python with the MCP SDK, it reads JSON log files from a configurable directory (defaulting to /var/log/mcp/json_logs) and expects entries with standard fields like timestamp, level, message, module, function, and line number. The implementation offers tools for searching logs by level, module, function, message content, and time ranges, aggregating data by various criteria (level, module, function, hour), generating overall statistics, and serving individual log files as resources, making it valuable for debugging Python applications, monitoring system behavior over time, and analyzing application performance patterns through structured log data.

## Trust

- **Trust score (0–1):** 0.50
- **Verification tier:** unverified

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** monitoring
- **Updated:** 2026-04-25

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/mfreeman451-json-logs)
- **Repository:** <https://github.com/mfreeman451/json-logs-mcp-server>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "mfreeman451-json-logs"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/mfreeman451-json-logs` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/mfreeman451-json-logs/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt