Basecamp MCP Server

Instructions

Implementation Reference

• src/lib/basecamp-client.ts:321-324 (handler)

  Core handler function that executes the tool logic: fetches comments via Basecamp API for the given project and recording.

  async getComments(projectId: string, recordingId: string): Promise<Comment[]> {
    const response = await this.client.get(`/buckets/${projectId}/recordings/${recordingId}/comments.json`);
    return response.data;
  }

• src/index.ts:771-783 (handler)

  MCP CallToolRequestHandler case for 'get_comments': extracts arguments, calls BasecampClient.getComments, formats JSON response.

  case 'get_comments': {
    const comments = await client.getComments(typedArgs.project_id, typedArgs.recording_id);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({
          status: 'success',
          comments,
          count: comments.length
        }, null, 2)
      }]
    };
  }

• src/index.ts:393-404 (registration)

  Registration of the 'get_comments' tool in ListToolsResponse, including description and input schema.

  {
    name: 'get_comments',
    description: 'Get comments for a Basecamp item',
    inputSchema: {
      type: 'object',
      properties: {
        recording_id: { type: 'string', description: 'The item ID' },
        project_id: { type: 'string', description: 'The project ID' },
      },
      required: ['recording_id', 'project_id'],
    },
  },

• src/types/basecamp.ts:139-145 (schema)

  TypeScript interface defining the structure of a Comment object returned by the tool.

  export interface Comment {
    id: string;
    content: string;
    created_at: string;
    updated_at: string;
    creator: Person;
  }