Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down
12 changes: 6 additions & 6 deletions go.sum
Original file line number Diff line number Diff line change
Expand Up @@ -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=
Expand Down Expand Up @@ -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=
Expand Down Expand Up @@ -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=
Expand Down
2 changes: 2 additions & 0 deletions internal/mcpserver/composite.go
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@ import (
const (
recordingsDomainKey = "recordings"
recordingsToolName = "basecamp_recordings"
recordingsToolTitle = "Basecamp Recordings"
summarizeAction = "summarize"
messagesDomainKey = "messages"
createCommentAction = "create_comment"
Expand Down Expand Up @@ -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),
Expand Down
16 changes: 16 additions & 0 deletions internal/mcpserver/domains.go
Original file line number Diff line number Diff line change
Expand Up @@ -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.",
},
Expand Down
46 changes: 23 additions & 23 deletions internal/mcpserver/testdata/catalog_snapshot.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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
Expand All @@ -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
Expand All @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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)
Expand All @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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)
Expand All @@ -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
Expand Down
Loading
Loading