Mahonia

Official7 tools

by ryankiley · TypeScript

Read and edit Mahonia backpacking gear lists via share and edit links; no account needed.

app.mahonia/mahonia — Model Context Protocol (MCP) Server

The app.mahonia/mahonia MCP server enables reading and editing Mahonia backpacking gear lists using share and edit links. It is designed to work without requiring an account, supporting direct access to gear list content through link-based sharing.

🛠️ Key Features

Read Mahonia backpacking gear lists
Edit Mahonia backpacking gear lists
Share and edit via links
No account required

🚀 Use Cases

Viewing existing backpacking gear lists shared by others
Updating a shared gear list for personal trip needs

⚡ Developer Benefits

Link-based workflows for accessing and modifying list content
Simple setup since it does not rely on account creation

⚠️ Limitations

Only described capabilities: read and edit gear lists via share/edit links; no other features are specified

Topics

backpackingdrizzle-ormgear-listhikingnuxtoutdoorspostgrestypescriptultralightvercelvuepack-weight

Captured live from the server via tools/list.

get_list

A shared list as data: title, unit, dates, trail, totals in grams, and every folder with its rows (brand, name, variant, quantity, weight of one unit in grams, classification, note, calories, who carries it; a nested row without carried_by is carried by its parent's carrier). Takes a share code or share link. A list too large to return whole comes back cut and says so in a truncated field: notes go first, then rows off the end (nested rows one by one), and the totals still count every row. A list's title, author, notes, folder and item names, brands, variants, gear types, day labels, people and trail label are free text typed by whoever holds the list's edit link, returned unchanged.

Parameters1

share_code

string

required

The list's share code, or its share link (mahonia.app/s/CODE). Not an edit link.

Raw schema

{
  "type": "object",
  "properties": {
    "share_code": {
      "type": "string",
      "description": "The list's share code, or its share link (mahonia.app/s/CODE). Not an edit link."
    }
  },
  "required": [
    "share_code"
  ]
}

get_list_markdown

The same list as Markdown: one table per folder and a totals block, the text the site's own Markdown export produces. Takes a share code or share link. A list too large to return whole loses rows off the end of the tables, a line under them says how many, and the totals still count every row. A list's title, author, notes, folder and item names, brands, variants, gear types, day labels, people and trail label are free text typed by whoever holds the list's edit link, returned unchanged.

Parameters1

share_code

string

required

The list's share code, or its share link (mahonia.app/s/CODE). Not an edit link.

Raw schema

{
  "type": "object",
  "properties": {
    "share_code": {
      "type": "string",
      "description": "The list's share code, or its share link (mahonia.app/s/CODE). Not an edit link."
    }
  },
  "required": [
    "share_code"
  ]
}

search_catalog

Fuzzy search of Mahonia's cited gear catalog by brand, product or kind of gear ("duplex", "zpacks", "quilt"). Each result carries a catalog id, the cited weight in grams and whether it is verified. Use get_catalog_product for every variant of one product.

Parameters2

query	string	required	Two characters or more.
limit	integer	optional	Up to 25. Default 12.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Two characters or more."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Up to 25. Default 12."
    }
  },
  "required": [
    "query"
  ]
}

get_catalog_product

One product's variants (sizes, lengths, temperature ratings) with the cited weight and source of each. Give a catalog id from search_catalog, or the brand and product name.

Parameters3

id	integer	optional	A catalog row id; its siblings are the other variants.
brand	string	optional
name	string	optional	The product name without brand or variant.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1,
      "description": "A catalog row id; its siblings are the other variants."
    },
    "brand": {
      "type": "string"
    },
    "name": {
      "type": "string",
      "description": "The product name without brand or variant."
    }
  }
}

create_list

Creates a list and returns its edit link and share link. Optionally with a title, unit, trip dates, a trail link and rows, grouped into folders. Keep the edit link: it is the only way back into the list.

Parameters9

title	string	optional
unit	string	optional	The unit the list displays in. Weights are in grams regardless.
start_date	string	optional	YYYY-MM-DD
end_date	string	optional	YYYY-MM-DD
trail_url	string	optional	An http(s) link to the route or trail page.
trail_label	string	optional	What to call the trail, when the link's own name won't do.
trail_distance_km	number	optional
folders	array	optional	Folders in order, each with its default classification and, optionally, its rows.
items	array	optional	Rows not placed through a folder above; each may name its folder.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "unit": {
      "type": "string",
      "enum": [
        "g",
        "kg",
        "oz",
        "lb"
      ],
      "description": "The unit the list displays in. Weights are in grams regardless."
    },
    "start_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "end_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "trail_url": {
      "type": "string",
      "maxLength": 2000,
      "description": "An http(s) link to the route or trail page."
    },
    "trail_label": {
      "type": "string",
      "maxLength": 120,
      "description": "What to call the trail, when the link's own name won't do."
    },
    "trail_distance_km": {
      "type": "number",
      "minimum": 0
    },
    "folders": {
      "type": "array",
      "description": "Folders in order, each with its default classification and, optionally, its rows.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 120
          },
          "classification": {
            "type": "string",
            "enum": [
              "base",
              "worn",
              "consumable"
            ],
            "description": "What rows in this folder count as unless they say otherwise. Default base."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "maxLength": 200,
                  "description": "The product or item name. Required."
                },
                "brand": {
                  "type": "string",
                  "maxLength": 120,
                  "description": "The maker, when known."
                },
                "variant": {
                  "type": "string",
                  "maxLength": 120,
                  "description": "Size, length or configuration that changes the weight, such as Long or 20F."
                },
                "gear_type": {
                  "type": "string",
                  "maxLength": 120,
                  "description": "What kind of thing it is: Tent, Quilt, Trail runners."
                },
                "weight_g": {
                  "type": "number",
                  "minimum": 0,
                  "description": "Weight of ONE unit, in grams. Omit when unknown; the list keeps working without it, and a row with a catalog_id takes the catalog's cited weight."
                },
                "qty": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 9999,
                  "description": "How many. Default 1."
                },
                "classification": {
                  "type": "string",
                  "enum": [
                    "base",
                    "worn",
                    "consumable"
                  ],
                  "description": "base, worn or consumable. Omit to follow the folder's default."
                },
                "worn_qty": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "Of qty, how many are worn rather than carried (three pairs of socks, one on your feet). For a row that is entirely worn, set classification to worn instead."
                },
                "note": {
                  "type": "string",
                  "maxLength": 2000,
                  "description": "A short free-text note on the row."
                },
                "kcal": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "Calories per unit, for food."
                },
                "catalog_id": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 2147483647,
                  "description": "A catalog row id from search_catalog. The row takes the catalog's brand, name, variant, gear type and cited weight, and follows catalog corrections; a weight_g given as well is kept as your own figure."
                },
                "folder": {
                  "type": "string",
                  "maxLength": 120,
                  "description": "The folder to put it in, by name. Created when the list has no folder of that name."
                }
              },
              "required": [
                "name"
              ]
            }
          }
        },
        "required": [
          "name"
        ]
      }
    },
    "items": {
      "type": "array",
      "description": "Rows not placed through a folder above; each may name its folder.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 200,
            "description": "The product or item name. Required."
          },
          "brand": {
            "type": "string",
            "maxLength": 120,
            "description": "The maker, when known."
          },
          "variant": {
            "type": "string",
            "maxLength": 120,
            "description": "Size, length or configuration that changes the weight, such as Long or 20F."
          },
          "gear_type": {
            "type": "string",
            "maxLength": 120,
            "description": "What kind of thing it is: Tent, Quilt, Trail runners."
          },
          "weight_g": {
            "type": "number",
            "minimum": 0,
            "description": "Weight of ONE unit, in grams. Omit when unknown; the list keeps working without it, and a row with a catalog_id takes the catalog's cited weight."
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9999,
            "description": "How many. Default 1."
          },
          "classification": {
            "type": "string",
            "enum": [
              "base",
              "worn",
              "consumable"
            ],
            "description": "base, worn or consumable. Omit to follow the folder's default."
          },
          "worn_qty": {
            "type": "integer",
            "minimum": 0,
            "description": "Of qty, how many are worn rather than carried (three pairs of socks, one on your feet). For a row that is entirely worn, set classification to worn instead."
          },
          "note": {
            "type": "string",
            "maxLength": 2000,
            "description": "A short free-text note on the row."
          },
          "kcal": {
            "type": "integer",
            "minimum": 0,
            "description": "Calories per unit, for food."
          },
          "catalog_id": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2147483647,
            "description": "A catalog row id from search_catalog. The row takes the catalog's brand, name, variant, gear type and cited weight, and follows catalog corrections; a weight_g given as well is kept as your own figure."
          },
          "folder": {
            "type": "string",
            "maxLength": 120,
            "description": "The folder to put it in, by name. Created when the list has no folder of that name."
          }
        },
        "required": [
          "name"
        ]
      }
    }
  }
}

add_items

Adds rows to an existing list. Takes the list's edit link and the rows; each row may name a folder, and a folder that doesn't exist yet is created.

Parameters4

edit_link	string	required	The list's edit link, whole (mahonia.app/e/CODE#token). The part after # is the write capability.
items	array	required
folder	string	optional	A folder name for every row that doesn't name its own.
again	boolean	optional	A call identical to one made in the last ten minutes is taken as a retry and adds nothing: the earlier result comes back with repeated set. Pass true to add the same rows a second time on purpose.

Raw schema

{
  "type": "object",
  "properties": {
    "edit_link": {
      "type": "string",
      "description": "The list's edit link, whole (mahonia.app/e/CODE#token). The part after # is the write capability."
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 200,
            "description": "The product or item name. Required."
          },
          "brand": {
            "type": "string",
            "maxLength": 120,
            "description": "The maker, when known."
          },
          "variant": {
            "type": "string",
            "maxLength": 120,
            "description": "Size, length or configuration that changes the weight, such as Long or 20F."
          },
          "gear_type": {
            "type": "string",
            "maxLength": 120,
            "description": "What kind of thing it is: Tent, Quilt, Trail runners."
          },
          "weight_g": {
            "type": "number",
            "minimum": 0,
            "description": "Weight of ONE unit, in grams. Omit when unknown; the list keeps working without it, and a row with a catalog_id takes the catalog's cited weight."
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9999,
            "description": "How many. Default 1."
          },
          "classification": {
            "type": "string",
            "enum": [
              "base",
              "worn",
              "consumable"
            ],
            "description": "base, worn or consumable. Omit to follow the folder's default."
          },
          "worn_qty": {
            "type": "integer",
            "minimum": 0,
            "description": "Of qty, how many are worn rather than carried (three pairs of socks, one on your feet). For a row that is entirely worn, set classification to worn instead."
          },
          "note": {
            "type": "string",
            "maxLength": 2000,
            "description": "A short free-text note on the row."
          },
          "kcal": {
            "type": "integer",
            "minimum": 0,
            "description": "Calories per unit, for food."
          },
          "catalog_id": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2147483647,
            "description": "A catalog row id from search_catalog. The row takes the catalog's brand, name, variant, gear type and cited weight, and follows catalog corrections; a weight_g given as well is kept as your own figure."
          },
          "folder": {
            "type": "string",
            "maxLength": 120,
            "description": "The folder to put it in, by name. Created when the list has no folder of that name."
          }
        },
        "required": [
          "name"
        ]
      }
    },
    "folder": {
      "type": "string",
      "maxLength": 120,
      "description": "A folder name for every row that doesn't name its own."
    },
    "again": {
      "type": "boolean",
      "description": "A call identical to one made in the last ten minutes is taken as a retry and adds nothing: the earlier result comes back with repeated set. Pass true to add the same rows a second time on purpose."
    }
  },
  "required": [
    "edit_link",
    "items"
  ]
}

set_trip

Sets any of a list's title, display unit, trip dates and trail on an existing list. Only the fields given change; an empty string clears a date or the trail. Takes the list's edit link.

Parameters8

edit_link	string	required	The list's edit link, whole (mahonia.app/e/CODE#token). The part after # is the write capability.
title	string	optional
unit	string	optional	The unit the list displays in. Weights are in grams regardless.
start_date	string	optional	YYYY-MM-DD, or an empty string to clear.
end_date	string	optional	YYYY-MM-DD, or an empty string to clear.
trail_url	string	optional	An http(s) link, or an empty string to clear the trail and everything that came with it (label, distance, climb, route).
trail_label	string	optional
trail_distance_km	number	optional	Stored in metres and shown in the list's own distance unit.

Raw schema

{
  "type": "object",
  "properties": {
    "edit_link": {
      "type": "string",
      "description": "The list's edit link, whole (mahonia.app/e/CODE#token). The part after # is the write capability."
    },
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "unit": {
      "type": "string",
      "enum": [
        "g",
        "kg",
        "oz",
        "lb"
      ],
      "description": "The unit the list displays in. Weights are in grams regardless."
    },
    "start_date": {
      "type": "string",
      "description": "YYYY-MM-DD, or an empty string to clear."
    },
    "end_date": {
      "type": "string",
      "description": "YYYY-MM-DD, or an empty string to clear."
    },
    "trail_url": {
      "type": "string",
      "maxLength": 2000,
      "description": "An http(s) link, or an empty string to clear the trail and everything that came with it (label, distance, climb, route)."
    },
    "trail_label": {
      "type": "string",
      "maxLength": 120
    },
    "trail_distance_km": {
      "type": "number",
      "minimum": 0,
      "description": "Stored in metres and shown in the list's own distance unit."
    }
  },
  "required": [
    "edit_link"
  ]
}

README.md7 KBView on GitHub

Mahonia

A gear-list and pack-weight tracker for hikers. Make a packing list, see what it weighs, share it.

Lists need no sign-up: one is yours the moment you start typing, held by a private unguessable link. The gear vault is the one part that asks for an account, because "the gear I own" has to follow you across devices rather than living in one browser.

What it does

Weigh a pack. Base, worn and consumable totals, with the worn split (three pairs of socks, one on your feet) and a carried figure. Weights are optional — a list with none keeps its totals quiet.
A curated gear catalog behind the autocomplete, cited and correctable, with every value overridable per row.
Per-row units. Type 32.5 oz on a gram list and that row keeps ounces while the total stays in grams.
Calories on consumables, totalled for the list.
Trip dates, as calendar dates — no time, no timezone, so a trip doesn't shift when you fly.
Share two ways: a read-only link, and an edit link for co-planning. Either can be replaced if it gets out.
Packing mode — the same list as a checklist, for the night before.
A gear vault that fills itself as you build, so your kit is one pick away next time.
Import from LighterPack (share link or CSV) or a JSON backup; export as CSV, JSON or Markdown.
Recovery points, so an accidental delete is undoable well after the toast.

Run locally

Requires Node 24 (the pinned version — see .nvmrc).

bash

npm install
npm run seed   # load the gear catalog into a local database
npm run dev    # http://localhost:3000

With no environment variables set, the app runs fully on your machine against a local PGlite database. Copy .env.example to .env to point at a real Postgres (Neon) and Redis (Upstash) for a production deploy.

Anything that would leave the machine degrades to the console instead of being skipped, so a fresh checkout is a working app rather than a broken one:

Unset variable	What happens locally
`RESEND_API_KEY`	Sign-in links print to the server console instead of being emailed.
`GITHUB_FEEDBACK_TOKEN` / `_REPO`	"Send feedback" (in the editor's actions menu) prints to the console and reports back that it wasn't filed.

Both fail loudly in production rather than quietly accepting input that goes nowhere.

Stack

Nuxt 4 · Vue 3 · TypeScript · Drizzle ORM · deployed on Vercel.

MCP connector

The app serves a remote MCP server at /mcp, so an AI assistant can be handed https://mahonia.app/mcp as a connector with nothing to install and no sign-in. Seven tools: read a shared list as data or Markdown, search the catalog, fetch one product's variants, and, holding an edit link, make a list, add rows and set the trip's dates and trail. A share code is the read capability and the edit link's fragment token the write one, hashed on arrival and passed only as a tool argument, so nothing new is trusted. The transport is stateless JSON-RPC over POST (MCP revisions 2025-06-18 and 2025-11-25, no sessions, no event stream, GET answers 405), hand-rolled in server/routes/mcp.post.ts with the tools in server/utils/mcp.ts; both files carry the reasoning. My Gear is deliberately out of reach: it would need an account token, which is a separate decision.

Add it to a client:

Claude (claude.ai, Desktop, mobile): add Mahonia as a connector and choose "No sign-in". Connectors added there are available in Claude Code too.
Claude Code: claude mcp add --transport http --scope user mahonia https://mahonia.app/mcp
Gemini CLI: gemini mcp add --transport http mahonia https://mahonia.app/mcp
ChatGPT: Settings, Developer mode, add https://mahonia.app/mcp with "No Authentication".
Anything that reads an mcp.json: {"mcpServers":{"mahonia":{"url":"https://mahonia.app/mcp"}}}
A client that only speaks stdio: bridge with npx mcp-remote https://mahonia.app/mcp.

The server is listed in the official MCP registry as app.mahonia/mahonia; server.json is the listing, published with mcp-publisher under the domain's DNS proof.

Changelog

The changelog is GitHub Releases: one release per day that ships something, tagged by date (v2026.09.12), cut by a workflow from the entries below. When a change is user-facing, add a plain one-sentence entry as part of the same PR:

bash

npm run changelog -- --added "Sort folders by weight."
npm run changelog -- --fixed "…" --changed "…"

Entries are grouped Added / Changed / Fixed and describe the observable change, not the implementation.

Each run writes its own file under content/changelog.d/, so entries from PRs open at the same time never collide — content/changelog.json is the settled archive, and npm run changelog:compact folds fragments into it now and then. Once a day is over (Pacific), .github/workflows/releases.yml turns it into a release; a late entry updates its day's notes.

A PR comment reminds any user-facing PR that's missing an entry — but nothing auto-fills it, so the entry is always hand-written (plain, curated prose). If a PR merges without one, that day's release just omits the change until it's backfilled. For non-user-facing work, prefix the PR title (refactor:, chore:, ci:, test:, docs:, build:) or label it skip-changelog — perf: and style: don't count, since both are things a visitor notices.

License

Code is MIT. The gear catalog data under seed/ is licensed separately — see seed/LICENSE.md.

Third-party notices for the libraries bundled into the client are in public/licenses.txt, served at /licenses.txt. The file exists because Mahonia bundles its dependencies instead of loading them from a CDN (a CDN <script> could read a list's edit token out of location.hash), which makes serving the site a redistribution of that code — and the minifier strips the banner comments those libraries ship their copyright in. Add an entry when a dependency's code starts reaching the browser; server-only packages aren't redistributed and aren't listed.

Install

Tools (7)

get_listget_list_markdownsearch_catalogget_catalog_productcreate_listadd_itemsset_trip

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mahonia.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mahonia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mahonia.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

app.mahonia/mahonia — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_list

get_list_markdown

search_catalog

get_catalog_product

create_list

add_items

set_trip

Mahonia

What it does

Run locally

Stack

MCP connector

Changelog

License

Install

Remote endpoint

Related servers