Basecamp MCP Server

Instructions

Implementation Reference

• src/lib/basecamp-client.ts:337-350 (handler)

  Core handler function that executes the document creation logic by posting to the Basecamp API.

  async createDocument(
    projectId: string,
    vaultId: string,
    title: string,
    content: string,
    status = 'active'
  ): Promise<Document> {
    const response = await this.client.post(`/buckets/${projectId}/vaults/${vaultId}/documents.json`, {
      title,
      content,
      status,
    });
    return response.data;
  }

• src/index.ts:422-431 (schema)

  Input schema for validating tool parameters in MCP tool calls.

  inputSchema: {
    type: 'object',
    properties: {
      project_id: { type: 'string', description: 'Project ID' },
      vault_id: { type: 'string', description: 'Vault ID' },
      title: { type: 'string', description: 'Document title' },
      content: { type: 'string', description: 'Document HTML content' },
    },
    required: ['project_id', 'vault_id', 'title', 'content'],
  },

• src/index.ts:420-432 (registration)

  Tool object registration in the MCP ListTools handler, defining name, description, and schema.

    name: 'create_document',
    description: 'Create a document in a vault',
    inputSchema: {
      type: 'object',
      properties: {
        project_id: { type: 'string', description: 'Project ID' },
        vault_id: { type: 'string', description: 'Vault ID' },
        title: { type: 'string', description: 'Document title' },
        content: { type: 'string', description: 'Document HTML content' },
      },
      required: ['project_id', 'vault_id', 'title', 'content'],
    },
  },

• src/index.ts:799-815 (handler)

  MCP CallToolRequest dispatch handler for create_document, invoking the client method and formatting the tool response.

  case 'create_document': {
    const document = await client.createDocument(
      typedArgs.project_id,
      typedArgs.vault_id,
      typedArgs.title,
      typedArgs.content
    );
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({
          status: 'success',
          document
        }, null, 2)
      }]
    };
  }