{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_z5n3jg89pthe","handle":"frontmatter-mcp","url":"https://wellknown.network/agents/frontmatter-mcp","links":{"self":"https://wellknown.network/agents/frontmatter-mcp/record.json","html":"https://wellknown.network/agents/frontmatter-mcp","markdown":"https://wellknown.network/agents/frontmatter-mcp/record.md","api":"https://wellknown.network/api/v1/agents/frontmatter-mcp","status":"https://wellknown.network/api/v1/agents/frontmatter-mcp/status","claim":"https://wellknown.network/agents/frontmatter-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/frontmatter-mcp/claim.json","badge":"https://wellknown.network/agents/frontmatter-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/frontmatter-mcp/history","tools":"https://wellknown.network/api/v1/agents/frontmatter-mcp/tools"},"ard":{"identifier":"urn:air::server:frontmatter-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"frontmatter-mcp","summary":"MCP server for querying Markdown frontmatter with DuckDB SQL","description":"# frontmatter-mcp\n\nAn MCP server for querying Markdown frontmatter with DuckDB SQL.\n\n## Configuration\n\n### Basic Usage\n\n```json\n{\n  \"mcpServers\": {\n    \"frontmatter\": {\n      \"command\": \"uvx\",\n      \"args\": [\"frontmatter-mcp\"],\n      \"env\": {\n        \"FRONTMATTER_BASE_DIR\": \"/path/to/markdown/directory\"\n      }\n    }\n  }\n}\n```\n\n### With Semantic Search\n\nSemantic search requires large dependencies (~1GB). Set `MCP_TIMEOUT` to extend installation timeout:\n\n```json\n{\n  \"mcpServers\": {\n    \"frontmatter\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"frontmatter-mcp[semantic]\", \"frontmatter-mcp\"],\n      \"env\": {\n        \"FRONTMATTER_BASE_DIR\": \"/path/to/markdown/directory\",\n        \"FRONTMATTER_ENABLE_SEMANTIC\": \"true\",\n        \"MCP_TIMEOUT\": \"300000\"\n      }\n    }\n  }\n}\n```\n\nNote: `MCP_TIMEOUT` is in milliseconds (300000 = 5 minutes).\n\n## Installation (Optional)\n\nIf you prefer to install globally:\n\n```bash\npip install frontmatter-mcp\n# or\nuv tool install frontmatter-mcp\n```\n\n## Tools\n\n### query_inspect\n\nGet schema information from frontmatter across files.\n\n| Parameter | Type   | Description                             |\n| --------- | ------ | --------------------------------------- |\n| `glob`    | string | Glob pattern relative to base directory |\n\n**Example:**\n\n```json\n// Input\n{ \"glob\": \"**/*.md\" }\n\n// Output\n{\n  \"file_count\": 186,\n  \"schema\": {\n    \"date\": { \"type\": \"string\", \"count\": 180, \"nullable\": true },\n    \"tags\": { \"type\": \"array\", \"count\": 150, \"nullable\": true }\n  }\n}\n\n// Output (with semantic search ready)\n{\n  \"file_count\": 186,\n  \"schema\": {\n    \"date\": { \"type\": \"string\", \"count\": 180, \"nullable\": true },\n    \"tags\": { \"type\": \"array\", \"count\": 150, \"nullable\": true },\n    \"embedding\": { \"type\": \"FLOAT[256]\", \"nullable\": false }\n  }\n}\n```\n\n### query\n\nQuery frontmatter data with DuckDB SQL.\n\n| Parameter | Type   | Description                                |\n| --------- | ------ | ------------------------------------------ |\n| `glob`    | string |…","publisher":{"name":"kzmshx","url":null},"homepage":"https://github.com/kzmshx/frontmatter-mcp","repository":"https://github.com/kzmshx/frontmatter-mcp","version":"0.5.3","license":"MIT License\n        \n        Copyright (c) 2025 kzmshx\n        …","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:frontmatter-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.733,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"frontmatter-mcp","registry":"pypi","observedAt":"2026-09-15T15:24:28.503Z","publishedAt":"2025-12-31T13:40:23.269630Z","latestVersion":"0.5.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"frontmatter-mcp","url":"https://pypi.org/project/frontmatter-mcp/","firstSeenAt":"2026-09-09T16:23:00.687Z","fetchedAt":"2026-09-15T15:22:20.579Z","normalizedAt":"2026-09-15T15:22:20.579Z"}]},"firstSeenAt":"2026-09-09T16:23:00.687Z","updatedAt":"2026-09-15T15:24:28.503Z"}