mcp-metsuke-crunchtools

Stateful reports catalog MCP server. Metsuke (目付 — the Sengoku intelligence officer who gathered field reports and compiled them for the daimyō) is the durable, cross-agent home for report definitions and their gathered outputs.

An autonomous gatherer reads a definition, sweeps the configured sources, and writes findings — each carrying its own source URL. A compiler later reads the freshest output to draft a fully cited report. This replaces ad-hoc, run-scoped research caches with a real, queryable store.

Features

  • Definitions + outputs — separate what-to-gather from what-was-gathered
  • Cited findings — payloads carry per-finding source URLs for one-click checking
  • Re-homeable gathering — owner_agent makes the gatherer identity data, not code
  • Local-first — plain SQLite (WAL), no external services, no per-seat fees
  • Three transports — stdio, SSE, streamable-http

Install

uvx (recommended)

uvx mcp-metsuke-crunchtools

pip

pip install mcp-metsuke-crunchtools

Container

podman run --rm -v ~/.local/share/mcp-metsuke:/data:Z \
  quay.io/crunchtools/mcp-metsuke \
  --transport streamable-http --host 0.0.0.0 --port 8009

Claude Code Integration

claude mcp add mcp-metsuke-crunchtools -- uvx mcp-metsuke-crunchtools

Tools (5)

Definitions (3)

Tool Description
list_reports List all report definitions in the catalog.
get_spec Return the gather prompt + source config for one definition.
upsert_definition Create or update a definition (name, prompt, owner, schedule, sources).

Outputs (2)

Tool Description
save_output Persist gathered findings for a report (each ideally carrying a source URL).
get_output Read the freshest output (or a specific day's) for compiling a report.

Environment Variables

Variable Default Description
METSUKE_DB ~/.local/share/mcp-metsuke/metsuke.db SQLite database path
METSUKE_DB_FILE (none) Path whose contents override METSUKE_DB (container secret-file convention)

Data Model

  • report_definitions — name (PK), gather_prompt, owner_agent, schedule, source_config (JSON), updated_at
  • report_outputs — id, report_name (FK), gathered_at, window_start/window_end, payload (JSON findings with source URLs), status (gathering/ready/compiled), gatherer_run_ref

MCP Registry

io.github.crunchtools/metsuke

License

AGPL-3.0-or-later

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for crunchtools from gravatar.com crunchtools

Credits

Author: crunchtools.com

License expression

AGPL-3.0-or-later
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev

Tags

automation catalog mcp reports sqlite

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_metsuke_crunchtools-0.2.0.tar.gz (35.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_metsuke_crunchtools-0.2.0-py3-none-any.whl (23.8 kB view details)

Uploaded Python 3

File details

Details for the file mcp_metsuke_crunchtools-0.2.0.tar.gz.

File metadata

  • Download URL: mcp_metsuke_crunchtools-0.2.0.tar.gz
  • Upload date:
  • Size: 35.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mcp_metsuke_crunchtools-0.2.0.tar.gz
Algorithm Hash digest
SHA256 e480fe2c5b9fb4c096699de337e1bad7364c48863265df1f2fb86761c8451db4
MD5 4d8e8707c2e15a47074041af73e68d50
BLAKE2b-256 748a448cfcf5f0cc9448d4482b9a3dd2d384eec483b4aea3fec1a4fe67a30ce0

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_metsuke_crunchtools-0.2.0.tar.gz:

Publisher: publish.yml on crunchtools/mcp-metsuke

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mcp_metsuke_crunchtools-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_metsuke_crunchtools-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6aadaa1ce8a118180c7b83cf962b1f31102b5465240e5bd92e98021a2627b73f
MD5 6eb8697b45d5f6f5f9904061c5e58a12
BLAKE2b-256 ff8f13cf94ff141d4813fab5bfd427fec42aab6870b2785467e82baf0b0cef19

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_metsuke_crunchtools-0.2.0-py3-none-any.whl:

Publisher: publish.yml on crunchtools/mcp-metsuke

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page