From 5ea4eecf32c34477744965c01d5a3c11790a3510 Mon Sep 17 00:00:00 2001 From: Jeremy Daer Date: Wed, 18 Nov 2026 17:21:30 -0800 Subject: [PATCH] Bump the basecamp/mcp toolkit, and title every MCP tool Move github.com/basecamp/mcp from the 2026-08-28 pin (2d6f44b) to 663b2e5, which carries the result paging and size-cap middleware and the eval multi-turn mode. go-sdk moves with it to the toolkit's own pin, so the flake's vendorHash is refreshed (make update-nix-hash, build verified). The toolkit now derives every gateway tool's annotations (title, idempotent, destructive, closed world) and refuses a domain without a title, so `basecamp mcp` failed to start: every catalog domain is untitled. Give each DomainSpec a "Basecamp ..." title, the shape the HEY and Fizzy servers use, and give the hand-built recordings domain one too. The catalog snapshot moves by exactly the toolkit's new "destructive" notes: the delete_*, destroy_*, trash_*, remove_* and unsubscribe actions its action-name classifier marks, which now also reach clients as destructiveHint. --- go.mod | 4 +- go.sum | 12 ++--- internal/mcpserver/composite.go | 2 + internal/mcpserver/domains.go | 16 +++++++ .../mcpserver/testdata/catalog_snapshot.txt | 46 +++++++++---------- nix/package.nix | 2 +- 6 files changed, 50 insertions(+), 32 deletions(-) diff --git a/go.mod b/go.mod index 729f5aa69..85171b8ca 100644 --- a/go.mod +++ b/go.mod @@ -10,7 +10,7 @@ require ( charm.land/lipgloss/v2 v2.0.6 github.com/basecamp/basecamp-sdk/go v0.36.0 github.com/basecamp/cli v0.2.2-0.20261023171439-c9bce8206df9 - github.com/basecamp/mcp v0.0.0-20260828100356-2d6f44b51e9d + github.com/basecamp/mcp v0.0.0-20261118214004-663b2e5d2836 github.com/basecamp/surfguard/go v0.1.0 github.com/charmbracelet/bubbles v1.0.0 github.com/charmbracelet/bubbletea v1.3.10 @@ -22,7 +22,7 @@ require ( github.com/godbus/dbus/v5 v5.2.2 github.com/gofrs/flock v0.13.1 github.com/itchyny/gojq v0.12.19 - github.com/modelcontextprotocol/go-sdk v1.8.0 + github.com/modelcontextprotocol/go-sdk v1.8.1-0.20261014132652-7c486efa8223 github.com/sigstore/sigstore-go v1.3.0 github.com/spf13/cobra v1.10.2 github.com/spf13/pflag v1.0.10 diff --git a/go.sum b/go.sum index 6575793d5..4684599ff 100644 --- a/go.sum +++ b/go.sum @@ -93,8 +93,8 @@ github.com/basecamp/basecamp-sdk/go v0.36.0 h1:mkAcJQlh+5Vz64OmpImSda/pfa/usWPJ6 github.com/basecamp/basecamp-sdk/go v0.36.0/go.mod h1:ynVJME8mVV3UHMUMnzBgygTnMtadQFxz1iYg7fqwUeM= github.com/basecamp/cli v0.2.2-0.20261023171439-c9bce8206df9 h1:3NfGs+zx23Tp6cf+97+UewrJHlzZMLzmvEXOmOJyQAk= github.com/basecamp/cli v0.2.2-0.20261023171439-c9bce8206df9/go.mod h1:iTBTaWvsPEFIcZfkxQHEfISyJ6sZ7036K6bNx0RY3EE= -github.com/basecamp/mcp v0.0.0-20260828100356-2d6f44b51e9d h1:zEQVGq1x1nhKMZ2TudFAcSJ32CHT8richI1vQakIKz4= -github.com/basecamp/mcp v0.0.0-20260828100356-2d6f44b51e9d/go.mod h1:Ee2c/q1/pg+5T5741PIuA3s6VJMQC7I0XBNXIHIujzA= +github.com/basecamp/mcp v0.0.0-20261118214004-663b2e5d2836 h1:ND4te8b+HVFFrgcm7+n8P83MKKPqBpIyoJ63tT9liRU= +github.com/basecamp/mcp v0.0.0-20261118214004-663b2e5d2836/go.mod h1:K3sgTH90CIR6Ed0XPnivIBqNIpw6aeOlcXThBrZ+2gc= github.com/basecamp/surfguard/go v0.1.0 h1:JMo+MZQEOBRqnUylzD0/jS9S42Fp+XKWMG+4LWfu/XE= github.com/basecamp/surfguard/go v0.1.0/go.mod h1:y5MWhE5S/CZAPzUOS0LoOYGUVxTeWFByFDssE3/l4b4= github.com/blang/semver v3.5.1+incompatible h1:cQNTCjp13qL8KC3Nbxr/y2Bqb63oX6wdnnjpJbkM4JQ= @@ -179,8 +179,8 @@ github.com/fsnotify/fsnotify v1.10.1 h1:b0/UzAf9yR5rhf3RPm9gf3ehBPpf0oZKIjtpKrx5 github.com/fsnotify/fsnotify v1.10.1/go.mod h1:TLheqan6HD6GBK6PrDWyDPBaEV8LspOxvPSjC+bVfgo= github.com/go-chi/chi/v5 v5.3.0 h1:halUjDxhshgXHMrao5bB8eNBXo/rnzwr8m5m36glehM= github.com/go-chi/chi/v5 v5.3.0/go.mod h1:R+tYY2hNuVUUjxoPtqUdgBqevM9s9njzkTLutVsOCto= -github.com/go-jose/go-jose/v4 v4.1.4 h1:moDMcTHmvE6Groj34emNPLs/qtYXRVcd6S7NHbHz3kA= -github.com/go-jose/go-jose/v4 v4.1.4/go.mod h1:x4oUasVrzR7071A4TnHLGSPpNOm2a21K9Kf04k1rs08= +github.com/go-jose/go-jose/v4 v4.1.5 h1:RjgjO2LOtWOJKUC5wpwY9LR3B3vwVAz6JS2YHfYU6eA= +github.com/go-jose/go-jose/v4 v4.1.5/go.mod h1:x4oUasVrzR7071A4TnHLGSPpNOm2a21K9Kf04k1rs08= github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A= github.com/go-logr/logr v1.4.4 h1:tG4xh9yMsRCAiodLVTxyrkzSZ9+o0L1Kg/+cPVcbP/8= github.com/go-logr/logr v1.4.4/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY= @@ -342,8 +342,8 @@ github.com/mitchellh/hashstructure/v2 v2.0.2 h1:vGKWl0YJqUNxE8d+h8f6NJLcCJrgbhC4 github.com/mitchellh/hashstructure/v2 v2.0.2/go.mod h1:MG3aRVU/N29oo/V/IhBX8GR/zz4kQkprJgF2EVszyDE= github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= -github.com/modelcontextprotocol/go-sdk v1.8.0 h1:KIvahhYqwtbeniWVPs3TcXEA7b8jEtwfBpOTAI+Urx4= -github.com/modelcontextprotocol/go-sdk v1.8.0/go.mod h1:dL7u98E/zjJTGzEq+j30jQ8K2k1mb6LeAH4inEcSGts= +github.com/modelcontextprotocol/go-sdk v1.8.1-0.20261014132652-7c486efa8223 h1:THyv0oM2i7h3ezGwwXWCOqwsh/C2rUTabh+ukQCiClE= +github.com/modelcontextprotocol/go-sdk v1.8.1-0.20261014132652-7c486efa8223/go.mod h1:dL7u98E/zjJTGzEq+j30jQ8K2k1mb6LeAH4inEcSGts= github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI= github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo= github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA= diff --git a/internal/mcpserver/composite.go b/internal/mcpserver/composite.go index 62b62bf73..3a0dbb82c 100644 --- a/internal/mcpserver/composite.go +++ b/internal/mcpserver/composite.go @@ -45,6 +45,7 @@ import ( const ( recordingsDomainKey = "recordings" recordingsToolName = "basecamp_recordings" + recordingsToolTitle = "Basecamp Recordings" summarizeAction = "summarize" messagesDomainKey = "messages" createCommentAction = "create_comment" @@ -96,6 +97,7 @@ func recordingsDomain() *catalog.Domain { return &catalog.Domain{ Key: recordingsDomainKey, Tool: recordingsToolName, + Title: recordingsToolTitle, Blurb: recordingsDomainDesc, Operations: []*catalog.Operation{ filingOperation(basecamp.FilingCopy), diff --git a/internal/mcpserver/domains.go b/internal/mcpserver/domains.go index 9559ec5da..2b0fb8ef2 100644 --- a/internal/mcpserver/domains.go +++ b/internal/mcpserver/domains.go @@ -21,81 +21,97 @@ import "github.com/basecamp/mcp/catalog" var DomainSpecs = []catalog.DomainSpec{ { Key: "projects", + Title: "Basecamp Projects", Tags: []string{"Projects"}, Blurb: "Basecamp projects: list, get, create, update, archive, unarchive, and trash.", }, { Key: "todos", + Title: "Basecamp To-dos", Tags: []string{"Todos", "Subtasks"}, Blurb: "Todos, todolists, todolist groups, and todosets — plus each todolist's hill chart, and the subtasks on to-dos and cards.", }, { Key: "cards", + Title: "Basecamp Card Tables", Tags: []string{"Card Tables"}, Blurb: "Card tables (kanban): cards, columns, steps, and wormholes, with moves, repositioning, and on-hold state.", }, { Key: "messages", + Title: "Basecamp Message Boards", Tags: []string{"Messages"}, Blurb: "Message boards: messages, comments, message types (categories), and pinning.", }, { Key: "campfires", + Title: "Basecamp Campfires & Pings", Tags: []string{"Campfire", "Pings"}, Blurb: "Campfire chat: rooms, chat lines, uploads, and chatbots, and Pings: private conversations, direct or group, each held in its own Campfire.", }, { Key: "boosts", + Title: "Basecamp Boosts", Tags: []string{"Boosts"}, Blurb: "Boosts (emoji reactions) on recordings and their events: list, get, create, update, and delete.", }, { Key: "schedules", + Title: "Basecamp Schedules", Tags: []string{"Schedule", "Calendars"}, Blurb: "Schedules and schedule entries (calendar events), timesheets and time tracking, and per-account calendars.", }, { Key: "files", + Title: "Basecamp Docs & Files", Tags: []string{"Files", "Folders", "Embeds"}, Blurb: "Docs & Files: vaults (folders), documents, uploads, attachments, embeds for rich text (videos, charts), cloud file links, Google documents, and home-screen project folders.", }, { Key: "people", + Title: "Basecamp People", Tags: []string{"People"}, Blurb: "People and access: profiles, pingable and assignable people, project access, out-of-office, preferences, and notification subscriptions.", }, { Key: "automation", + Title: "Basecamp Automation", Tags: []string{"Checkins", "Templates", "Webhooks", "Lineup", "Dock", "Recordings", "Search"}, Blurb: "Automatic check-ins (questionnaires, questions, answers, reminders), project templates and the template library, webhooks, lineup markers, dock tools and external links (doors), recording lifecycle (archive/trash), change events, and search.", }, { Key: "reports", + Title: "Basecamp Reports", Tags: []string{"Reports", "Timeline"}, Blurb: "Reports and timelines: progress, assigned and overdue todos, upcoming schedule, per-person progress, and project timelines.", }, { Key: "everything", + Title: "Basecamp Everything", Tags: []string{"Everything"}, Blurb: "Account-wide feeds: every checkin, comment, file, forward, and message, and cards and todos filtered by state (open, completed, overdue, unassigned, no due date, not now).", }, { Key: "eventfeed", + Title: "Basecamp Event Feed", Tags: []string{"EventFeed"}, Blurb: "The account event feed: poll events from a resumable position, and poll the agent inbox of addressed items. Pages carry a position and a continuation URL rather than page numbers; deduplicate events by id and inbox items by addressing_id, and refetch the referenced recording before acting on it. Minting a live-stream ticket is not served here — the ticket is a bearer this surface cannot use, and 'basecamp events ticket' is where it lives.", }, { Key: "clientside", + Title: "Basecamp Clientside", Tags: []string{"ClientFeatures"}, Blurb: "The Clientside: client approvals, correspondences, replies, and client visibility of recordings.", }, { Key: "forwards", + Title: "Basecamp Email Forwards", Tags: []string{"Forwards"}, Blurb: "Email forwards: project inboxes, forwarded emails, and their replies.", }, { Key: "account", + Title: "Basecamp Account", Tags: []string{"Account", "Gauges", "MyAssignments", "MyNotes", "MyNotifications", "Bookmarks", "BubbleUps", "Drafts"}, Blurb: "Account info and your personal surface: gauges and needles, my assignments and priorities, notifications and bubble-ups, bookmarks, bubbling recordings up, personal note, and drafts.", }, diff --git a/internal/mcpserver/testdata/catalog_snapshot.txt b/internal/mcpserver/testdata/catalog_snapshot.txt index f451ef723..c79868ad6 100644 --- a/internal/mcpserver/testdata/catalog_snapshot.txt +++ b/internal/mcpserver/testdata/catalog_snapshot.txt @@ -11,9 +11,9 @@ ACTIONS (RO = read-only): - list_projects (RO, paginated): List projects (active by default; optionally archived/trashed) - list_recent_projects (RO): List the projects the current user has most recently visited, most recent visit first - record_project_visit: Record that the current user visited a project, moving it to the front of ListRecentProjects (returns 204 No Content) -- remove_project_logo: Remove the project's logo (returns 204 even when absent) -- remove_project_wallpaper: Remove the project's wallpaper (returns 204 No Content) -- trash_project: Trash a project (returns 204 No Content) +- remove_project_logo (destructive): Remove the project's logo (returns 204 even when absent) +- remove_project_wallpaper (destructive): Remove the project's wallpaper (returns 204 No Content) +- trash_project (destructive): Trash a project (returns 204 No Content) - unarchive_project: Restore a project to active status from trash as well as from the archive (returns 204 No Content) - update_project: Update an existing project @@ -32,7 +32,7 @@ ACTIONS (RO = read-only): - create_todolist: Create a new todolist in a todoset - create_todolist_group: Create a new group in a todolist - create_todoset_todo: Create a to-do directly under a project's to-do set, outside any to-do list -- delete_subtask: Delete a subtask +- delete_subtask (destructive): Delete a subtask - get_hill_chart (RO): Get the hill chart for a todoset - get_hill_chart_version (RO): Get one progress update from a todoset's hill chart - get_subtask (RO): Get a subtask by ID @@ -66,7 +66,7 @@ ACTIONS (RO = read-only): - create_card_column: Create a column in a card table - create_card_step: Create a step on a card - create_wormhole: Add a wormhole to a card table: a standing shortcut that sends cards to a column on another card table, usually in another project -- delete_wormhole: Permanently delete a card table's wormhole, the shortcut that sends cards to another card table +- delete_wormhole (destructive): Permanently delete a card table's wormhole, the shortcut that sends cards to another card table - disable_card_column_on_hold: Disable on-hold section in a column - enable_card_column_on_hold: Enable on-hold section in a column - get_card (RO): Get a card by ID @@ -80,7 +80,7 @@ ACTIONS (RO = read-only): - set_card_column_color: Set the color of a column - set_card_step_completion: Set card step completion status (PUT with completion: "on" to complete, "" to uncomplete) - subscribe_to_card_column: Subscribe to a card column (watch for changes) -- unsubscribe_from_card_column: Unsubscribe from a card column (stop watching for changes) +- unsubscribe_from_card_column (destructive): Unsubscribe from a card column (stop watching for changes) - update_card: Update an existing card - update_card_column: Update an existing column - update_card_step: Update an existing step @@ -96,7 +96,7 @@ ACTIONS (RO = read-only): - create_comment: Create a new comment on a recording. Accepts a synthetic mentions parameter, expanded client-side. - create_message: Create a new message on a message board - create_message_type: Create a new message type in a project -- delete_message_type: Delete a message type +- delete_message_type (destructive): Delete a message type - get_comment (RO): Get a single comment by id - get_message (RO): Get a single message by id - get_message_board (RO): Get a message board @@ -120,8 +120,8 @@ ACTIONS (RO = read-only): - create_campfire_line: Create a new line (message) in a campfire - create_chatbot: Create a new chatbot for a campfire - create_ping: Create a Ping with people, or return the one that already holds exactly them -- delete_campfire_line: Delete a campfire line; allowed for the line's creator or an admin -- delete_chatbot: Delete a chatbot +- delete_campfire_line (destructive): Delete a campfire line; allowed for the line's creator or an admin +- delete_chatbot (destructive): Delete a chatbot - get_campfire (RO): Get a campfire by ID - get_campfire_line (RO): Get a campfire line by ID - get_chatbot (RO): Get a chatbot by ID @@ -143,7 +143,7 @@ Call {"action": "describe", "params": {"action": "NAME"}} for an action's full p ACTIONS (RO = read-only): - create_event_boost: Create a boost on a specific event within a recording - create_recording_boost: Create a boost on a recording -- delete_boost: Delete a boost +- delete_boost (destructive): Delete a boost - get_boost (RO): Get a single boost - list_event_boosts (RO, paginated): List boosts on a specific event within a recording - list_recording_boosts (RO, paginated): List boosts on a recording @@ -158,7 +158,7 @@ Call {"action": "describe", "params": {"action": "NAME"}} for an action's full p ACTIONS (RO = read-only): - create_schedule_entry: Create a new schedule entry - create_timesheet_entry: Create a timesheet entry on a recording -- destroy_timesheet_entry: Permanently delete a timesheet entry, which never appears in the trash and cannot be restored; this is the only way to remove one, since bc3 answers 403 to TrashRecording and ArchiveRecording for every timesheet entry, and it answers 403 when the caller may not remove the entry +- destroy_timesheet_entry (destructive): Permanently delete a timesheet entry, which never appears in the trash and cannot be restored; this is the only way to remove one, since bc3 answers 403 to TrashRecording and ArchiveRecording for every timesheet entry, and it answers 403 when the caller may not remove the entry - get_calendar (RO): Get a calendar by its bucket id - get_project_timesheet (RO, paginated): Get timesheet for a specific project - get_recording_timesheet (RO, paginated): Get timesheet for a specific recording @@ -188,7 +188,7 @@ ACTIONS (RO = read-only): - create_upload: Create a new upload in a vault - create_upload_version: Replace an upload's file with a new version - create_vault: Create a new vault (subfolder) in a vault -- delete_folder: Delete a folder and unpin its projects from the home screen (returns 204 No Content) +- delete_folder (destructive): Delete a folder and unpin its projects from the home screen (returns 204 No Content) - get_cloud_file (RO): Get a single cloud file by id - get_document (RO): Get a single document by id - get_embed (RO): Get an embed by its sgid @@ -229,7 +229,7 @@ ACTIONS (RO = read-only): - list_pingable_people (RO, paginated): List all account users who can be pinged - list_project_people (RO, paginated): List all active people on a project - subscribe: Subscribe the current user to a recording -- unsubscribe: Unsubscribe the current user from a recording +- unsubscribe (destructive): Unsubscribe the current user from a recording - update_my_preferences: Update the current user's preferences - update_my_profile: Update the current authenticated user's profile (returns 204 No Content) - update_project_access: Update project access (grant/revoke/create people) @@ -256,11 +256,11 @@ ACTIONS (RO = read-only): - create_templatification: Templatify a to-do list or card table - create_tool: Create a tool in a project dock - create_webhook: Create a new webhook for a project -- delete_door: Delete an external link (returns 204 No Content) Its status becomes "deleted" and it leaves the project's External links section -- delete_lineup_marker: Delete a lineup marker -- delete_template: Delete a template (trash it) -- delete_tool: Remove a tool from the dock: deletes an external link or an empty extra tool, and disables any other tool (returns 204 No Content either way) -- delete_webhook: Delete a webhook +- delete_door (destructive): Delete an external link (returns 204 No Content) Its status becomes "deleted" and it leaves the project's External links section +- delete_lineup_marker (destructive): Delete a lineup marker +- delete_template (destructive): Delete a template (trash it) +- delete_tool (destructive): Remove a tool from the dock: deletes an external link or an empty extra tool, and disables any other tool (returns 204 No Content either way) +- delete_webhook (destructive): Delete a webhook - disable_tool: Disable a tool (hide it from the project dock) - enable_tool: Enable a tool (show it on the project dock) - get_answer (RO): Get a single answer by id @@ -293,7 +293,7 @@ ACTIONS (RO = read-only): - resume_question: Resume a paused check-in question (resumes sending reminders) - search (RO, paginated): Search for content across the account - spotlight_recording: Put a recording's card in the spotlight area on its project or template home page -- trash_recording: Trash a recording; bc3 answers 403 for types it never lets be trashed, timesheet entries among them (DestroyTimesheetEntry removes those, permanently) +- trash_recording (destructive): Trash a recording; bc3 answers 403 for types it never lets be trashed, timesheet entries among them (DestroyTimesheetEntry removes those, permanently) - unarchive_recording: Unarchive a recording (restore to active status) - unspotlight_recording: Remove a recording from the spotlight area - update_answer: Update an existing answer @@ -391,10 +391,10 @@ ACTIONS (RO = read-only): - create_bookmark: Bookmark a recording for the current user - create_bubble_up: Bubble up a recording for the current user, resurfacing it in the current user's readings (the BC5 successor to "save") - create_gauge_needle: Create a gauge needle (progress update) for a project -- delete_bookmark: Remove the current user's bookmark from a recording (returns 204 No Content) -- delete_bubble_up: Remove the current user's bubble-up from a recording (returns 204 No Content) +- delete_bookmark (destructive): Remove the current user's bookmark from a recording (returns 204 No Content) +- delete_bubble_up (destructive): Remove the current user's bubble-up from a recording (returns 204 No Content) - deprioritize_assignment: Remove a recording from Up Next (returns 204 No Content) -- destroy_gauge_needle: Destroy a gauge needle +- destroy_gauge_needle (destructive): Destroy a gauge needle - get_account (RO): Get the account for the current access token - get_bookmark (RO): Report whether the current user has bookmarked the recording - get_bubble_ups (RO, paginated): Get the current user's current and scheduled bubble-ups (paginated, 50 per page) @@ -410,7 +410,7 @@ ACTIONS (RO = read-only): - list_my_drafts (RO, paginated): List the current user's drafts across their active projects, most recently updated first (paginated, capped at 250 like /my/assignments) - mark_as_read: Mark specified items as read - prioritize_assignment: Add a recording to Up Next — the current user's ordered list of prioritized assignments (the priorities returned by GetMyAssignments) -- remove_account_logo: Remove the account logo +- remove_account_logo (destructive): Remove the account logo - reorder_up_next: Move an already-prioritized recording to a new 1-based position in Up Next (returns 204 No Content) - toggle_gauge: Enable or disable the gauge for a project - update_account_name: Rename the current account diff --git a/nix/package.nix b/nix/package.nix index 814aff57c..4b6c9d3b6 100644 --- a/nix/package.nix +++ b/nix/package.nix @@ -8,7 +8,7 @@ buildGoModule.override { go = go_1_26; } (finalAttrs: { src = lib.cleanSource ./..; # To update: set to lib.fakeHash, run `nix build`, use the hash from the error. - vendorHash = "sha256-7OOmoZp90XyeXz6As8zVsaaslPWIeNDplenzbOEuE3A="; + vendorHash = "sha256-YmTf0U8ORBITbKfQLkCBakOlbMmzaK7XukmYu/NteI8="; subPackages = [ "cmd/basecamp" ];