Knowledge Base updated: 2026-11-19
Last30Days knowledge base
Last30Days is a research skill and MCP integration for gathering recent, cited web intelligence and presenting it as terminal or HTML briefings.
The Python skill runtime lives under skills/last30days/; its command entrypoint coordinates planning, provider retrieval, quality processing, specialized modes, persistence, and rendering. The Go MCP integration in mcp/ exposes that runtime to MCP clients.
Configuration, credentials, hosted execution constraints, and HTTP/process safety are handled by shared runtime helpers. Packaging metadata, agent-host descriptors, release automation, and tests define the supported distribution and quality boundaries.
flowchart TD
U[CLI or MCP client] --> CLI[last30days.py]
U --> MCP[Go MCP server]
MCP --> CLI
CLI --> PLAN[Planner and query shaping]
PLAN --> RET[Providers and connectors]
RET --> QUAL[Normalize, ground, rank]
QUAL --> MODE[Specialized research modes]
MODE --> OUT[Briefing and rendering]
CLI --> STORE[Watchlists and library]
CLI --> RT[Runtime environment]
RT --> NET[HTTP and subprocess boundaries]
OUT --> R[Terminal / HTML results]
TEST[Python evaluation suite] --> CLI
PKG[Plugin packaging and release automation] --> CLI
Glossary
- Last30Days — the skill runtime and its research command surface.
- Briefing — structured research output assembled from ranked findings and rendered for a user.
- Provider — a source-specific retrieval implementation selected by the planner and connector layer.
- Preflight — checks that configuration, credentials, permissions, and dependencies support a planned run.
- MCP embedded engine — the extracted skill runtime managed by the MCP server.
Invariants
- Research requests pass through the CLI orchestration and shared pipeline rather than provider-specific command paths (skills/…/last30days.py, skills/…/pipeline.py).
- Provider access remains behind shared dispatch and transport helpers (skills/…/backends.py, skills/…/providers.py, skills/…/http.py).
- Findings are normalized and quality-checked before final rendering (skills/…/normalize.py, skills/…/grounding.py, skills/…/render.py).
- Runtime configuration and hosted behavior are centralized in environment helpers (skills/…/env.py, skills/…/hosted.py).
- Client-facing MCP capabilities are declared through the MCP manifest (mcp/manifest.json).
Routing table
- skills/…/last30days.py -> Research skill execution
- skills/…/pipeline.py -> Research skill execution
- skills/…/planner.py -> Research planning and query construction
skills/last30days/scripts/lib/{query,topics,resolve}*.py-> Research planning and query constructionskills/last30days/scripts/lib/{backends,providers}.py-> Source retrieval and connectorsskills/last30days/scripts/lib/{connectors,providers}/**-> Source retrieval and connectorsskills/last30days/scripts/lib/{grounding,normalize,signals}.py-> Research quality and rankingskills/last30days/scripts/lib/{rank*,dedup*,cluster*}.py-> Research quality and rankingskills/last30days/scripts/lib/{render,report_checklist,schema}.py-> Briefings and rendered outputskills/last30days/scripts/lib/{briefing*,publish*}.py-> Briefings and rendered outputskills/last30days/scripts/lib/{watchlist*,library*,store*,feed*}.py-> Watchlists, library, and stored researchskills/last30days/scripts/lib/job_boards/**-> Competitor and hiring research modesskills/last30days/scripts/lib/{competitor*,hiring*,jobs*}.py-> Competitor and hiring research modesskills/last30days/scripts/lib/{patent*,publication*}.py-> Patent research modetests/eval/fixtures/patent*/**-> Patent research modeskills/last30days/scripts/lib/{person,person_linkedin,employer_site}.py-> Person research mode- skills/…/env.py -> Runtime configuration and safety
- skills/…/hosted.py -> Runtime configuration and safety
skills/last30days/scripts/lib/{setup*,credentials*,preflight*}.py-> Setup, credentials, and preflight- skills/…/doctor.py -> Health diagnostics and recovery
skills/last30days/scripts/lib/{health*,diagnostic*}.py-> Health diagnostics and recovery- skills/…/http.py -> Execution boundaries and HTTP access
skills/last30days/scripts/lib/{subprocess*,cookies*}.py-> Execution boundaries and HTTP access- mcp/manifest.json -> MCP integration
- mcp/…/*.go -> MCP server and research tools
mcp/**/*embed*-> MCP embedded enginemcp/**/*extract*-> MCP embedded engine- .claude-plugin/marketplace.json -> Distribution and host integrations
- CHANGELOG.md -> Distribution and host integrations
- .claude-plugin/plugin.json -> Agent and plugin packaging
- .codex-plugin/plugin.json -> Agent and plugin packaging
- skills/…/SKILL.md -> Agent and plugin packaging
.github/workflows/**-> Automation, release, and security- CHANGELOG.md -> Automation, release, and security
tests/**-> Evaluation and regression suitetests/eval/**-> Evaluation and regression suite- pyproject.toml -> Evaluation and regression suite