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_agentmakes 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 |
|---|---|
metsuke_list_reports |
List all report definitions in the catalog. |
metsuke_get_spec |
Return the gather prompt + source config for one definition. |
metsuke_upsert_definition |
Create or update a definition (name, prompt, owner, schedule, sources). |
Outputs (2)
| Tool | Description |
|---|---|
metsuke_save_output |
Persist gathered findings for a report (each ideally carrying a source URL). |
metsuke_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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_metsuke_crunchtools-0.1.0.tar.gz.
File metadata
- Download URL: mcp_metsuke_crunchtools-0.1.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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d71d2bd6af7fb048cadd0cdf4c7942c9e9f59789d8e13e86391436aeb82ad8b1
|
|
| MD5 |
7ea5ff521f3d0cf4fc1745165eb0433c
|
|
| BLAKE2b-256 |
b0fac1096d4c0fd585e2d4962cc776064883667be26add8ed529a3d98be29fac
|
Provenance
The following attestation bundles were made for mcp_metsuke_crunchtools-0.1.0.tar.gz:
Publisher:
publish.yml on crunchtools/mcp-metsuke
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mcp_metsuke_crunchtools-0.1.0.tar.gz -
Subject digest:
d71d2bd6af7fb048cadd0cdf4c7942c9e9f59789d8e13e86391436aeb82ad8b1 - Sigstore transparency entry: 2644592036
- Sigstore integration time:
-
Permalink:
crunchtools/mcp-metsuke@0dd33de498e70700d4758cf8a9afd7c463291595 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/crunchtools
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@0dd33de498e70700d4758cf8a9afd7c463291595 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file mcp_metsuke_crunchtools-0.1.0-py3-none-any.whl.
File metadata
- Download URL: mcp_metsuke_crunchtools-0.1.0-py3-none-any.whl
- Upload date:
- Size: 23.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
da23ed26bd3094dad523cd704cac042ddcf311cb65d052d4c642d8c0feda765a
|
|
| MD5 |
b474e9c7f722e146e11229b4e73cfe31
|
|
| BLAKE2b-256 |
fc223d61eb3e6885918a1caea891e71d0e23c3c341bf8765d79c3290b5717a82
|
Provenance
The following attestation bundles were made for mcp_metsuke_crunchtools-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on crunchtools/mcp-metsuke
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mcp_metsuke_crunchtools-0.1.0-py3-none-any.whl -
Subject digest:
da23ed26bd3094dad523cd704cac042ddcf311cb65d052d4c642d8c0feda765a - Sigstore transparency entry: 2644592132
- Sigstore integration time:
-
Permalink:
crunchtools/mcp-metsuke@0dd33de498e70700d4758cf8a9afd7c463291595 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/crunchtools
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@0dd33de498e70700d4758cf8a9afd7c463291595 -
Trigger Event:
workflow_dispatch
-
Statement type:
