MCP server for querying Markdown frontmatter with DuckDB SQL
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"frontmatter-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# frontmatter-mcp An MCP server for querying Markdown frontmatter with DuckDB SQL. ## Configuration ### Basic Usage ```json { "mcpServers": { "frontmatter": { "command": "uvx", "args": ["frontmatter-mcp"], "env": { "FRONTMATTER_BASE_DIR": "/path/to/markdown/directory" } } } } ``` ### With Semantic Search Semantic search requires large dependencies (~1GB). Set `MCP_TIMEOUT` to extend installation timeout: ```json { "mcpServers": { "frontmatter": { "command": "uvx", "args": ["--from", "frontmatter-mcp[semantic]", "frontmatter-mcp"], "env": { "FRONTMATTER_BASE_DIR": "/path/to/markdown/directory", "FRONTMATTER_ENABLE_SEMANTIC": "true", "MCP_TIMEOUT": "300000" } } } } ``` Note: `MCP_TIMEOUT` is in milliseconds (300000 = 5 minutes). ## Installation (Optional) If you prefer to install globally: ```bash pip install frontmatter-mcp # or uv tool install frontmatter-mcp ``` ## Tools ### query_inspect Get schema information from frontmatter across files. | Parameter | Type | Description | | --------- | ------ | --------------------------------------- | | `glob` | string | Glob pattern relative to base directory | **Example:** ```json // Input { "glob": "**/*.md" } // Output { "file_count": 186, "schema": { "date": { "type": "string", "count": 180, "nullable": true }, "tags": { "type": "array", "count": 150, "nullable": true } } } // Output (with semantic search ready) { "file_count": 186, "schema": { "date": { "type": "string", "count": 180, "nullable": true }, "tags": { "type": "array", "count": 150, "nullable": true }, "embedding": { "type": "FLOAT[256]", "nullable": false } } } ``` ### query Query frontmatter data with DuckDB SQL. | Parameter | Type | Description | | --------- | ------ | ------------------------------------------ | | `glob` | string |…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.