footnote-mcp

OCI · GHCR.IO/KAZKOZDEV/FOOTNOTE-MCP:0.2.3 · 2 COMPONENTS · SCANNED AUG 3

Source-grounded web research: search, extraction, verification, and browser automation.

Available components

oci · ghcr.io/kazkozdev/footnote-mcp:0.2.3 36 pypi · footnote-mcp 36

0 this week 36 36 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security0

Malware scan not yet available for this package.Unverified
CVE data not yet available for this package.Unverified
Install-script risk not yet assessed.Unverified
Dependency-health data not yet available.Unverified

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 10 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability54

AI-judged instruction clarity (fair).Partial
Tool/resource definitions use about 2733 tokens (~60/item across 45 items; 45 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management23

Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage77

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
32% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

oci · ghcr.io/kazkozdev/footnote-mcp:0.2.3

Claude Codex opencode Hermes Other

# add to Claude Code

claude mcp add kazkozdev-footnote-mcp -- docker run --rm -i ghcr.io/kazkozdev/footnote-mcp:0.2.3

# add to Codex CLI

codex mcp add kazkozdev-footnote-mcp -- docker run --rm -i ghcr.io/kazkozdev/footnote-mcp:0.2.3

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kazkozdev-footnote-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/kazkozdev/footnote-mcp:0.2.3"
      ],
      "enabled": true
    }
  }
}

# ~/.hermes/config.yaml

mcp_servers:
  kazkozdev-footnote-mcp:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/kazkozdev/footnote-mcp:0.2.3"]

// mcp.json

{
  "mcpServers": {
    "kazkozdev-footnote-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/kazkozdev/footnote-mcp:0.2.3"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +3
- Stability: unverified → 0.23 ▲ functional
31 Jul 26 −3
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
27 Jul 26 +25
- Tool coverage: unverified → 100 ▲ functional
- First check of Tool coverage: 32 functional
- First check of Schema quality: fair functional
- First check of Schema quality: fail functional
- First check of Schema quality: pass functional
26 Jul 26 11

First indexed and scored.
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed oci/ghcr.io/kazkozdev/footnote-mcp:0.2.3

Provenance none

Ecosystem: oci · Outcome: none

Reason: no_attestation

MCP tools — 45 exposed · ~2,733 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

archive_search ~105

Find archived captures of a URL or host through the Wayback Machine and Common Crawl; optionally extract archived text.

Input Output Examples

Name	Type	Req	Description
fetch_text	boolean	—	—
lang	string	—	—
num	integer	—	—
source	string	—	auto \| wayback \| common_crawl
timestamp	string	—	Optional Wayback target YYYYMMDD or YYYYMMDDhhmmss
url	string	yes	Full URL, host, or Common Crawl URL pattern

No output schema declared.

No examples provided.

browser_extract_tables ~38

Extract visible tables from the current browser page after navigation/interactions.

Input Output Examples

Name	Type	Req	Description
max_rows	integer	—	—
max_tables	integer	—	—

No output schema declared.

No examples provided.

browser_extract_tables_for_date_range ~67

Set date range in the current browser page, submit it, then extract visible tables.

Input Output Examples

Name	Type	Req	Description
end_date	string	yes	YYYY-MM-DD
max_rows	integer	—	—
max_tables	integer	—	—
start_date	string	yes	YYYY-MM-DD

No output schema declared.

No examples provided.

browser_set_date_range ~53

Best-effort browser date-range setter for interactive pages with date inputs.

Input Output Examples

Name	Type	Req	Description
end_date	string	yes	YYYY-MM-DD
start_date	string	yes	YYYY-MM-DD
submit	boolean	—	—

No output schema declared.

No examples provided.

build_research_debug_report ~68

Build a compact diagnostic report for a research run: queries, URLs, source quality, and verification gaps.

Input Output Examples

Name	Type	Req	Description
requirements	object	—	—
search_memory	object	—	—
sources	array	—	—
task	string	yes	—
verification	object	—	—

No output schema declared.

No examples provided.

check_date_completeness ~108

Validate date-range completeness for structured results. Supports day, week, and month granularity.

Input Output Examples

Name	Type	Req	Description
actual_items	array	yes	—
calendar	string	—	calendar \| business_day \| crypto_24_7 \| forex_weekday \| us_business_day \| ru_business_day
end_date	string	yes	YYYY-MM-DD
granularity	string	—	day \| week \| month
holidays	array	—	—
start_date	string	yes	YYYY-MM-DD

No output schema declared.

No examples provided.

classify_source ~59

Classify a source as official, aggregator, blog, forum, interactive, blocked, or error.

Input Output Examples

Name	Type	Req	Description
content_type	string	—	—
status_code	integer	—	—
text_sample	string	—	—
url	string	yes	—

No output schema declared.

No examples provided.

corroborate_claim ~67

Triangulate a claim across multiple source excerpts; returns a corroboration verdict (corroborated/conflicting/single_source/...).

Input Output Examples

Name	Type	Req	Description
backend	string	—	heuristic \| auto \| ollama \| local_nli
claim	string	yes	—
excerpts	array	yes	—

No output schema declared.

No examples provided.

encyclopedia_search ~89

Search Wikipedia articles and Wikidata entities, or execute a read-only Wikidata SPARQL query.

Input Output Examples

Name	Type	Req	Description
lang	string	—	—
num	integer	—	—
query	string	yes	Entity/topic query; still required when sparql is supplied
source	string	—	auto \| wikipedia \| wikidata
sparql	string	—	Optional read-only SPARQL SELECT query

No output schema declared.

No examples provided.

evidence_entailment ~75

Strict entailment check for claim vs source excerpt. Supports heuristic, Ollama judge, or auto fallback.

Input Output Examples

Name	Type	Req	Description
backend	string	—	auto \| heuristic \| ollama \| local_nli
claim	string	yes	—
model	string	—	Optional Ollama model name
source_excerpt	string	yes	—

No output schema declared.

No examples provided.

export_dataset ~71

Write extracted rows to a consolidated file (csv | xlsx | json) and return the path.

Input Output Examples

Name	Type	Req	Description
columns	array	—	—
format	string	—	csv \| xlsx \| json
path	string	—	Optional output path; defaults to cache exports dir
rows	array	yes	—

No output schema declared.

No examples provided.

generate_search_queries ~52

Generate specialized search queries using operators like site:, filetype:, API, CSV, and data-table variants.

Input Output Examples

Name	Type	Req	Description
max_queries	integer	—	—
requirements	object	—	—
task	string	yes	—

No output schema declared.

No examples provided.

github_search ~64

Search public GitHub repositories, issues, code, or commits. Authentication is optional; zero-key requests use GitHub's public rate limit.

Input Output Examples

Name	Type	Req	Description
kind	string	—	repositories \| issues \| code \| commits
num	integer	—	—
query	string	yes	—

No output schema declared.

No examples provided.

locate_claim_span ~59

Locate the sentence(s) in a source that best support a claim, with character offsets and a containment score (span-level provenance).

Input Output Examples

Name	Type	Req	Description
claim	string	yes	—
max_spans	integer	—	—
source_text	string	yes	—

No output schema declared.

No examples provided.

papers_search ~66

Search scientific publications through Crossref and arXiv. Uses no API key and returns one normalized paper result shape.

Input Output Examples

Name	Type	Req	Description
lang	string	—	—
num	integer	—	—
query	string	yes	—
source	string	—	auto \| crossref \| arxiv

No output schema declared.

No examples provided.

recipe_registry ~62

Manage promoted extraction recipes: list, get, run, or delete saved recipes.

Input Output Examples

Name	Type	Req	Description
action	string	yes	list \| get \| run \| delete
input_payload	object	—	—
recipe_id	string	—	—
source_text	string	—	—

No output schema declared.

No examples provided.

reconcile_time_series ~61

Align several time series on a common key, compute deltas vs the first series, and flag missing keys and outliers.

Input Output Examples

Name	Type	Req	Description
on	string	—	Key field to align on
series	array	yes	—
value_field	string	—	—

No output schema declared.

No examples provided.

resolve_units ~32

Resolve units, currencies, and currency pairs from text so incompatible rows can be rejected.

Input Output Examples

Name	Type	Req	Description
text	string	yes	—

No output schema declared.

No examples provided.

source_cache_get ~25

Read persistent source cache entry for a URL.

Input Output Examples

Name	Type	Req	Description
url	string	yes	—

No output schema declared.

No examples provided.

source_cache_put ~33

Write arbitrary parsed source payload into persistent source cache.

Input Output Examples

Name	Type	Req	Description
payload	object	yes	—
url	string	yes	—

No output schema declared.

No examples provided.

startup_health_check ~25

Check optional parser, OCR, browser, and cache dependencies for this MCP server.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

tool_code_generate ~37

Generate a safe starter extraction recipe function for the proposed spec. The result must still be validated before running.

Input Output Examples

Name	Type	Req	Description
spec	object	—	—

No output schema declared.

No examples provided.

tool_code_run_sandboxed ~72

Run validated extraction recipe code in a separate limited subprocess. Code must define extract(source_text, input_payload).

Input Output Examples

Name	Type	Req	Description
code	string	yes	—
input_payload	object	—	—
max_output_chars	integer	—	—
source_text	string	—	—
timeout	integer	—	—

No output schema declared.

No examples provided.

tool_code_validate ~40

Statically validate task-specific extraction code against the safe recipe contract and allowlist.

Input Output Examples

Name	Type	Req	Description
code	string	yes	—
max_chars	integer	—	—

No output schema declared.

No examples provided.

tool_promote ~77

Save a validated extraction recipe as reusable memory after an optional smoke test. Does not edit the MCP server.

Input Output Examples

Name	Type	Req	Description
code	string	yes	—
expected_min_rows	integer	—	—
input_payload	object	—	—
name	string	yes	—
sample_source_text	string	—	—
spec	object	—	—

No output schema declared.

No examples provided.

tool_spec_propose ~58

Propose a controlled task-specific extraction recipe spec when generic tools cannot extract structured rows.

Input Output Examples

Name	Type	Req	Description
desired_output	string	—	—
observed_failure	string	—	—
source_url	string	—	—
task	string	yes	—

No output schema declared.

No examples provided.

validate_unit_rows ~51

Reject structured rows that are incompatible with the expected unit, currency, or currency pair.

Input Output Examples

Name	Type	Req	Description
expected_unit_or_pair	string	yes	—
rows	array	yes	—
text_fields	array	—	—

No output schema declared.

No examples provided.

web_archive_fetch ~73

Find the closest Wayback Machine snapshot of a URL (for dead or changed sources) and optionally read its text.

Input Output Examples

Name	Type	Req	Description
fetch_text	boolean	—	—
lang	string	—	—
timestamp	string	—	Optional target YYYYMMDD or YYYYMMDDhhmmss
url	string	yes	—

No output schema declared.

No examples provided.

web_click ~43

Click an interactive element by its ref (e.g. @e3 from web_snapshot).

Input Output Examples

Name	Type	Req	Description
ref	string	yes	Element ref from web_snapshot, like @e3

No output schema declared.

No examples provided.

web_crawl ~71

Breadth-first crawl from a start URL, fetching and extracting each page. Stays on the start host by default. Capped at 50 pages.

Input Output Examples

Name	Type	Req	Description
lang	string	—	—
max_pages	integer	—	—
same_domain	boolean	—	—
start_url	string	yes	—

No output schema declared.

No examples provided.

web_deep_search ~127

Intent-routed deep research: discover through web/papers/encyclopedia/GitHub/archive sources, then fetch, extract, rerank, and return source-grounded context.

Input Output Examples

Name	Type	Req	Description
lang	string	—	Language code
num	integer	—	Maximum discovery results before fetching
provider	string	—	Web provider: auto \| searxng \| tavily \| brave \| google \| scrape
query	string	yes	Search query
sources	array	—	Optional explicit source intents: web, papers, encyclopedia, github, archive. Empty enables automatic routing.

No output schema declared.

No examples provided.

web_detect_downloads ~50

Detect downloadable CSV/XLS/XLSX/PDF/JSON/XML links on a page.

Input Output Examples

Name	Type	Req	Description
lang	string	—	—
max_links	integer	—	—
url	string	yes	—

No output schema declared.

No examples provided.

web_extract ~58

Extract text from the page. refs: comma-separated @eN, or 'visible' for all visible text, or 'all' for full HTML.

Input Output Examples

Name	Type	Req	Description
refs	string	yes	Comma-separated refs, or 'visible', or 'all'

No output schema declared.

No examples provided.

web_extract_tables ~66

Fetch a page, parse HTML tables, and return structured columns/rows with source URL provenance.

Input Output Examples

Name	Type	Req	Description
lang	string	—	—
max_rows	integer	—	—
max_tables	integer	—	—
url	string	yes	—
use_cache	boolean	—	—

No output schema declared.

No examples provided.

web_fetch_authenticated ~68

Fetch a page that needs cookies or custom headers (logged-in or gated pages).

Input Output Examples

Name	Type	Req	Description
cookies	object	—	name→value cookie map
headers	object	—	extra request headers
lang	string	—	—
timeout	integer	—	—
url	string	yes	—

No output schema declared.

No examples provided.

web_fetch_json ~57

Fetch an API/JSON URL directly and return parsed JSON with source URL provenance and persistent cache.

Input Output Examples

Name	Type	Req	Description
lang	string	—	—
timeout	integer	—	—
url	string	yes	—
use_cache	boolean	—	—

No output schema declared.

No examples provided.

web_navigate ~28

Navigate the browser to a URL.

Input Output Examples

Name	Type	Req	Description
url	string	yes	Full URL to navigate to

No output schema declared.

No examples provided.

web_parse_file ~64

Download and parse CSV/TSV/XLSX/PDF/JSON files, returning structured rows or extracted text with provenance.

Input Output Examples

Name	Type	Req	Description
lang	string	—	—
max_rows	integer	—	—
url	string	yes	—
use_cache	boolean	—	—

No output schema declared.

No examples provided.

web_read ~53

Fetch and extract text from a single URL. Returns extracted content (markdown).

Input Output Examples

Name	Type	Req	Description
lang	string	—	Language code
url	string	yes	Full URL to fetch and extract
use_cache	boolean	—	—

No output schema declared.

No examples provided.

web_screenshot ~49

Capture a PNG screenshot of the current browser page, save it to disk, and optionally OCR text locked inside the image.

Input Output Examples

Name	Type	Req	Description
full_page	boolean	—	—
ocr	boolean	—	—

No output schema declared.

No examples provided.

web_scroll ~34

Scroll the page: up, down, top, bottom.

Input Output Examples

Name	Type	Req	Description
direction	string	yes	up \| down \| top \| bottom

No output schema declared.

No examples provided.

web_search ~119

General web discovery. Uses configured SearXNG first, then keyed providers, then scraped Bing + DuckDuckGo. Returns normalized titles, URLs, snippets and scores.

Input Output Examples

Name	Type	Req	Description
lang	string	—	Language code: en, ru, etc.
num	integer	—	Max results to return
provider	string	—	auto \| searxng \| tavily \| brave \| google \| scrape
query	string	yes	Search query
semantic	boolean	—	Rerank results by meaning using local bge-m3 embeddings

No output schema declared.

No examples provided.

web_search_recent ~65

Web search restricted to a recency window via DuckDuckGo's date filter (day/week/month/year).

Input Output Examples

Name	Type	Req	Description
freshness	string	—	day \| week \| month \| year
lang	string	—	—
num	integer	—	—
query	string	yes	—

No output schema declared.

No examples provided.

web_snapshot ~42

Capture the current page state: URL, title, accessibility tree with stable refs (@e1, @e2...), and visible text. Use this before clicking/typing.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

web_type ~52

Type text into an input field by its ref.

Input Output Examples

Name	Type	Req	Description
ref	string	yes	Input field ref from web_snapshot
submit	boolean	—	Press Enter after typing
text	string	yes	Text to type

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	11
27 Jul	36
28 Jul	36
29 Jul	36
30 Jul	36
31 Jul	33
1 Aug	33
2 Aug	33
3 Aug	36