Basecamp MCP Server

Instructions

Implementation Reference

• src/index.ts:566-577 (handler)

  MCP tool handler for get_project: extracts project_id from args, calls BasecampClient.getProject(), formats result as JSON text content.

  case 'get_project': {
    const project = await client.getProject(typedArgs.project_id);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({
          status: 'success',
          project
        }, null, 2)
      }]
    };
  }

• src/index.ts:116-126 (registration)

  Tool registration in ListTools handler, including name, description, and input schema requiring project_id.

  {
    name: 'get_project',
    description: 'Get details for a specific project',
    inputSchema: {
      type: 'object',
      properties: {
        project_id: { type: 'string', description: 'The project ID' },
      },
      required: ['project_id'],
    },
  },

• src/lib/basecamp-client.ts:86-89 (helper)

  BasecampClient method implementing the API call to fetch a specific project by ID.

  async getProject(projectId: string): Promise<BasecampProject> {
    const response = await this.client.get(`/projects/${projectId}.json`);
    return response.data;
  }