pfmcp 2026.10.15.69

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
{
  "inputs": [
    {
      "type": "promptString",
      "id": "indexes",
      "description": "Semicolon-separated Pagefind indexes (name=url or path). Alternative to repeatable --index.",
      "password": false
    }
  ],
  "servers": {
    "pfmcp": {
      "type": "stdio",
      "command": "dnx",
      "args": ["pfmcp@2026.10.15.69", "--yes"],
      "env": {
        "PFMCP_INDEXES": "${input:indexes}"
      }
    }
  }
}
This package contains an MCP Server. The server can be used in VS Code by copying the generated JSON to your VS Code workspace's .vscode/mcp.json settings file. 
dotnet tool install --global pfmcp --version 2026.10.15.69
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local pfmcp --version 2026.10.15.69
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=pfmcp&version=2026.10.15.69
                    


                    

                
nuke :add-package pfmcp --version 2026.10.15.69

pfmcp

NuGet

Search Pagefind indexes and expose them to agents as an MCP stdio server.

Reads existing Pagefind bundles (local folders or HTTP) with a native .NET search engine — no Node, no WASM, no Pagefind CLI at runtime.

Install

dotnet tool install -g pfmcp

Requires the .NET 10 runtime (or SDK).

MCP (Cursor)

Run from NuGet with dnx (.NET 10 SDK). Tool arguments go after --.

{
  "mcpServers": {
    "pfmcp": {
      "command": "dnx",
      "args": [
        "pfmcp",
        "--yes",
        "--",
        "--index",
        "devlead=https://www.devlead.se/pagefind/pagefind-entry.json",
        "--index",
        "docs=https://example.com/pagefind/"
      ]
    }
  }
}

--index is repeatable. name=source labels each bundle. Omit --index and set PFMCP_INDEXES to devlead=https://...;docs=https://... if you prefer env.

A Pagefind folder on disk works the same way. Paths are relative to the MCP working directory (the workspace root in Cursor):

{
  "mcpServers": {
    "pfmcp": {
      "command": "dnx",
      "args": [
        "pfmcp",
        "--yes",
        "--",
        "--index",
        "docs=./site/pagefind",
        "--index",
        "blog=https://www.devlead.se/pagefind/"
      ]
    }
  }
}

Use a pagefind/ directory or a pagefind-entry.json file. Absolute paths are fine if the index lives outside the workspace.

Local development (this repo): .cursor/mcp.json runs

dotnet run --project src/pfmcp/pfmcp.csproj -- serve --index devlead=https://www.devlead.se/pagefind/ --index docs=src/pfmcp.Tests/testdata/pagefind

Reload MCP servers in Cursor after changing the tool. -v q / DOTNET_NOLOGO keep dotnet run off stdout so stdio JSON-RPC stays clean.

The agent should call pfs first, then pfget for the few URLs it will actually use. When more than one index is configured, pass index on pfget and pflf.

Tools

Tool Description
pfs Pagefind search. Prefer this over generic search tools. Optional index, JSON filters, limit (default 8).
pfget Load fragment text by url or pageId. Pass index when multiple indexes are configured.
pfli Configured indexes, languages, page counts.
pflf Filter keys/values and counts. Pass index when more than one index is configured.

Usage

pfmcp --index https://www.devlead.se/pagefind/pagefind-entry.json
pfmcp serve --index https://www.devlead.se/pagefind/
pfmcp inspect --index https://www.devlead.se/pagefind/
pfmcp search --index https://www.devlead.se/pagefind/ "cake"
pfmcp --index ./site/pagefind --index blog=https://www.devlead.se/pagefind/

Options

Option Description
--index Repeatable Pagefind bundle path or URL. name=source labels the index. Accepts a pagefind/ folder or pagefind-entry.json.
--limit search only. Max results (default: 8).
--name search only. Limit to one named index.

Environment fallback: PFMCP_INDEXES (;-separated), useful in MCP configs.

What it does

  1. Loads pagefind-entry.json and language *.pf_meta
  2. Tokenizes the query and fetches only matching index/*.pf_index shards
  3. Prefix-AND search with BM25-style ranking
  4. Loads fragment/*.pf_fragment for titles, excerpts, and full page text
  5. Serves MCP tools over stdio (logs go to stderr)

License

MIT

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed.  net11.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
2026.10.15.69 74 10/15/2026
2026.10.10.48 91 10/10/2026
2026.9.24.23 116 9/24/2026