Connect an agent to the wiki

This runbook adds the wiki to an agent through the Model Context Protocol (MCP), which lets an agent call tools on a server. Use it to give a new agent read access to the wiki, or when an agent cannot read it. The endpoint is https://wiki.lolwtf.ca/mcp. It is public and read-only, and it needs no token.

Before you start#

• You need an MCP client that connects to remote servers over HTTP.
• To check the endpoint, you need curl and jq.

Connect a client#

1. If the client is Claude Code, add the server.

   claude mcp add --transport http homelab-wiki https://wiki.lolwtf.ca/mcp

   Result: The command prints Added HTTP MCP server homelab-wiki with URL: https://wiki.lolwtf.ca/mcp to local config.

2. If the client is Claude Desktop, open Settings > Connectors. Select Add custom connector. Enter the name homelab-wiki and the URL https://wiki.lolwtf.ca/mcp.

3. If the client reads a JSON config file, add this server to the file.

   {
     "mcpServers": {
       "homelab-wiki": { "type": "http", "url": "https://wiki.lolwtf.ca/mcp" }
     }
   }

4. Start a new session in the client.

5. Tell the agent to list the wiki pages.

   Result: The agent calls list_pages and shows the pages by section.

Check the endpoint#

1. List the tools.

   curl -s https://wiki.lolwtf.ca/mcp -H 'content-type: application/json' \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq -r '.result.tools[].name'

   Result: The command prints list_pages, search and read_page, one on each line.

2. Read one page.

   curl -s https://wiki.lolwtf.ca/mcp -H 'content-type: application/json' \
     -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"read_page","arguments":{"page":"apps/wiki"}}}' \
     | jq -r '.result.content[0].text' | head -2

   Result: The command prints # Wiki and https://wiki.lolwtf.ca/apps/wiki/.

If something goes wrong#

Related#

• Wiki
• Connect an agent to kthx