Skip to content

Releases

v0.4.2

Choose a tag to compare

@swiftj swiftj released this 26 Oct 04:19

LegendKeeper for Claude Desktop, covering chat and Cowork, which runs inside Desktop.

New since 0.3.0

100% API coverage

Every one of the 89 LegendKeeper v3 API operations, and every request field, is reachable through a tool. docs/API_COVERAGE.md shows the mapping, and a test fails the build if a gap opens.

  • Sidebar order: update_resource reorders with after/before, and list_resources shows entries in sidebar order with their ranks.
  • Resources: icons, lock, banner, permissions, documents of any type at creation, and create_resources for up to 100 at once.
  • Block edits without rewriting the page: read_block, insert_block, replace_block, update_block, move_block, delete_block, assign_block_ids.
  • Properties of every kind, in the sidebar or in an infobox on a page, plus single-row set_row/delete_row.
  • Documents: every type, tab order, full width, delete_document, restore_document.
  • Assets: get_asset, create_asset_folder, update_asset.
  • Members and invites: list_members, list_invites, invite_member (sends an email; the skill tells Claude to confirm with you first), remove_member, revoke_invite.
  • Smaller additions: template, lane, event and map-feature ids and placement; event date precision; multi-part regions; reading a single lane, event, feature or board page.

Icons that work

  • find_icon: searches a built-in directory of all 1,402 free Font Awesome 6 icons by idea ("king", "ship", "magic") or category. It makes no API call.
  • Icon names are cleaned up before they're sent: fa- prefixes and capitals are dropped, and old Font Awesome 5 names are translated (home → house).
  • Rejected icons get a hint that points to find_icon.

61 tools (18 read, 43 write) and 4 prompts.

Downloads

File What it is
lk-mcp-darwin-arm64.mcpb Claude Desktop extension: the lk-mcp server for Apple Silicon Macs.
legendkeeper-plugin.zip Skills plugin: legendkeeper-wiki and legendkeeper-worldbuilding.
SHA256SUMS Checksums. Check them with shasum -a 256 -c SHA256SUMS.

Install or upgrade

  1. Double-click lk-mcp-darwin-arm64.mcpb. If an older version is installed, Claude Desktop replaces it and keeps your settings: the API key, the terms file and Read-only.
  2. In Claude Desktop, open Customize, then Add › Upload plugin, and choose legendkeeper-plugin.zip.
  3. Start a new chat or Cowork task, so it picks up the new tools and skills.

See the README for full instructions. The extension isn't code-signed, so Claude Desktop may say so when you install it.

The icon directory is built from Font Awesome Free's metadata (MIT). Not affiliated with or endorsed by LegendKeeper or Fonticons.

v0.3.0

Choose a tag to compare

@swiftj swiftj released this 25 Oct 22:12

LegendKeeper for Claude Desktop, covering chat and Cowork, which runs inside Desktop.

New in 0.3.0

  • delete_asset: remove an image, map image, audio file or folder from the asset library, for example the old version after uploading a replacement.
    • A dry run names what would go, and for a folder counts everything inside it.
    • A deleted image stays on pages that already show it, but its URL can't be added anywhere new.
    • It needs an admin API key.
  • MCP prompts: summarize_topic, edit_page_safely, add_map_location and session_notes, ready-made requests for multi-step jobs. The write prompts appear only when writing is enabled.
  • Skills apply in chat too, not just Cowork. The wiki skill now covers replacing an image: upload, swap, delete the old one.
  • Minimum Claude Desktop version: 3.6556.2.

Downloads

File What it is
lk-mcp-darwin-arm64.mcpb Claude Desktop extension: the lk-mcp server (40 tools, 4 prompts) for Apple Silicon Macs.
legendkeeper-plugin.zip Skills plugin: legendkeeper-wiki and legendkeeper-worldbuilding.
SHA256SUMS Checksums. Check them with shasum -a 256 -c SHA256SUMS.

Install or upgrade

  1. Double-click lk-mcp-darwin-arm64.mcpb. If an older version is installed, Claude Desktop replaces it and keeps your settings: the API key, the terms file and Read-only.
  2. In Claude Desktop, open Customize, then Add › Upload plugin, and choose legendkeeper-plugin.zip.
  3. Start a new chat or Cowork task, so it picks up the new tools and skills.

See the README for full instructions. The extension isn't code-signed, so Claude Desktop may say so when you install it.

Not affiliated with or endorsed by LegendKeeper.

v0.2.0

Choose a tag to compare

@swiftj swiftj released this 25 Oct 19:58

The first public release of the LegendKeeper integration for Claude Desktop, covering chat and Cowork, which runs inside Desktop.

Downloads

File What it is
lk-mcp-darwin-arm64.mcpb Claude Desktop extension: the lk-mcp server (39 tools) for Apple Silicon Macs. Double-click to install.
legendkeeper-plugin.zip Skills plugin: two skills, legendkeeper-wiki and legendkeeper-worldbuilding. Upload under Customize › Plugins › Add › Upload plugin.
SHA256SUMS Checksums for both files. Check them with shasum -a 256 -c SHA256SUMS.

Install

  1. Double-click lk-mcp-darwin-arm64.mcpb and enter a LegendKeeper API key. Use a test project first.
  2. Leave Spoiler terms file empty for full DM access, or choose a file of protected terms (one per line) to turn on the spoiler guard.
  3. In a new chat, ask: "List my LegendKeeper projects."
  4. Optional: upload legendkeeper-plugin.zip under Customize › Plugins to add the skills. Cowork uses the same extension and skills automatically.

See the README for full instructions.

What's in it

  • Read and write pages (as lossless LK Markdown), resources, documents, sidebar properties and images, plus maps, timelines, calendars, templates and boards.
  • Safe writes:
    • A versioned write never overwrites an edit made in the app since Claude read it.
    • Every write tool has dry_run.
    • Content Markdown can't express is kept.
  • Optional spoiler guard: with a terms file, a write that would show a protected term to players is refused. Secret blocks and hidden pages, documents and properties may still hold those terms.
  • The lk Go SDK the server is built on: go get github.com/swiftj/golk/lk@v0.2.0.

Notes

  • Apple Silicon macOS only for the Desktop extension. Linux binaries can be built from source (make build). Windows and Intel Macs aren't supported.
  • The extension isn't signed, so Claude Desktop may say so when you install it.

Not affiliated with or endorsed by LegendKeeper.