SendGrid MCP Server

Instructions

Implementation Reference

• src/services/sendgrid.ts:102-107 (handler)

  The core handler function in SendGridService that performs the API call to delete a marketing contact list by its ID.

  async deleteList(listId: string): Promise<void> {
    await this.client.request({
      method: 'DELETE',
      url: `/v3/marketing/lists/${listId}`
    });
  }

• src/tools/index.ts:230-243 (registration)

  The tool registration definition including name, description, and input schema for the 'delete_list' tool in getToolDefinitions.

  {
    name: 'delete_list',
    description: 'Delete a contact list from SendGrid',
    inputSchema: {
      type: 'object',
      properties: {
        list_id: {
          type: 'string',
          description: 'ID of the contact list to delete'
        }
      },
      required: ['list_id']
    }
  },

• src/tools/index.ts:446-448 (handler)

  The switch case handler in handleToolCall that invokes the service.deleteList method and returns a success message.

  case 'delete_list':
    await service.deleteList(args.list_id);
    return { content: [{ type: 'text', text: `Contact list ${args.list_id} deleted successfully` }] };

• src/tools/index.ts:233-241 (schema)

  The input schema definition for the 'delete_list' tool, specifying the required 'list_id' parameter.

  inputSchema: {
    type: 'object',
    properties: {
      list_id: {
        type: 'string',
        description: 'ID of the contact list to delete'
      }
    },
    required: ['list_id']