{
    "name": "jfoss-essays",
    "description": "A public, no-auth MCP server over a folder of markdown/yaml essays.",
    "essay_count": 1,
    "mcp": {
        "url": "https://www.jerzyfoss.co.uk/mcp",
        "transport": "streamable-http (stateless, JSON responses)",
        "auth": "none",
        "tools": [
            {
                "name": "latest_essays",
                "description": "List the most recently published essays (newest first) with title, date, summary and tags.",
                "inputSchema": {
                    "type": "object",
                    "properties": {
                        "limit": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 50,
                            "default": 10,
                            "description": "How many to return"
                        }
                    }
                }
            },
            {
                "name": "search_essays",
                "description": "Search essay titles, tags, summaries and bodies. Default mode \"bm25\" ranks by relevance for a plain-words query; mode \"regex\" matches a PCRE pattern (case-insensitive, no delimiters, e.g. \"zero[- ]trust|\\bTEE\\b\"). Returns ranked matches with snippets.",
                "inputSchema": {
                    "type": "object",
                    "properties": {
                        "query": {
                            "type": "string",
                            "description": "Words to search for (bm25) or a regex pattern (regex)"
                        },
                        "mode": {
                            "type": "string",
                            "enum": [
                                "bm25",
                                "regex"
                            ],
                            "default": "bm25"
                        },
                        "limit": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 50,
                            "default": 10
                        }
                    },
                    "required": [
                        "query"
                    ]
                }
            },
            {
                "name": "read_essay",
                "description": "Read one essay in full (markdown) by its slug, as returned by latest_essays or search_essays.",
                "inputSchema": {
                    "type": "object",
                    "properties": {
                        "slug": {
                            "type": "string",
                            "description": "Essay slug"
                        }
                    },
                    "required": [
                        "slug"
                    ]
                }
            }
        ]
    },
    "connect": {
        "claude_code": "claude mcp add --transport http jfoss-essays https://www.jerzyfoss.co.uk/mcp",
        "claude_desktop_or_other_json": {
            "mcpServers": {
                "jfoss-essays": {
                    "type": "http",
                    "url": "https://www.jerzyfoss.co.uk/mcp"
                }
            }
        },
        "curl_list_tools": "curl -s https://www.jerzyfoss.co.uk/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'",
        "curl_call_tool": "curl -s https://www.jerzyfoss.co.uk/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"latest_essays\",\"arguments\":{\"limit\":5}}}'"
    },
    "plain_http": [
        "https://www.jerzyfoss.co.uk/api/essays",
        "https://www.jerzyfoss.co.uk/api/essays/{slug}"
    ],
    "latest": [
        {
            "slug": "genie",
            "title": "Genie",
            "date": "2026-10-03",
            "summary": "The Genie is out of the bottle on AI agents and personal assistants. Instinct and Muse have taken the tech world by storm. While it's going to take a while to determine whether the current use cases a…",
            "tags": [],
            "words": 830,
            "url": "https://www.jerzyfoss.co.uk/api/essays/genie"
        }
    ]
}