Basecamp MCP Server

Instructions

Implementation Reference

• src/index.ts:552-564 (handler)

  MCP tool handler for 'get_projects': fetches projects using BasecampClient and returns JSON-formatted response with status, projects list, and count.

  case 'get_projects': {
    const projects = await client.getProjects();
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({
          status: 'success',
          projects,
          count: projects.length
        }, null, 2)
      }]
    };
  }

• src/index.ts:108-115 (registration)

  Tool registration in the listTools response, including name, description, and empty input schema (no parameters required).

  {
    name: 'get_projects',
    description: 'Get all Basecamp projects',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  },

• src/index.ts:111-114 (schema)

  Input schema definition for the 'get_projects' tool, specifying an empty object (no input parameters).

  inputSchema: {
    type: 'object',
    properties: {},
  },

• src/lib/basecamp-client.ts:81-84 (helper)

  Core implementation in BasecampClient: makes API call to fetch all projects from Basecamp and returns typed array.

  async getProjects(): Promise<BasecampProject[]> {
    const response = await this.client.get('/projects.json');
    return response.data;
  }